diff --git a/rust-bindings/rust/Makefile b/rust-bindings/rust/Makefile
index 0606c7ab..d579cb45 100644
--- a/rust-bindings/rust/Makefile
+++ b/rust-bindings/rust/Makefile
@@ -1,7 +1,7 @@
GIR_REPO := https://github.com/gtk-rs/gir.git
GIR_VERSION := e8f82cf63f2b2fba7af9440248510c4b7e5ab787
OSTREE_REPO := ../ostree
-OSTREE_VERSION := patch-v2021.1
+OSTREE_VERSION := patch-v2022.2
RUSTDOC_STRIPPER_VERSION := 0.1.17
all: gir
diff --git a/rust-bindings/rust/gir-files/OSTree-1.0.gir b/rust-bindings/rust/gir-files/OSTree-1.0.gir
index 9a93767a..9799111e 100644
--- a/rust-bindings/rust/gir-files/OSTree-1.0.gir
+++ b/rust-bindings/rust/gir-files/OSTree-1.0.gir
@@ -16,31 +16,31 @@ and/or use gtk-doc annotations. -->
A %NULL-terminated array of #OstreeCollectionRef instances, designed to
+ line="73">A %NULL-terminated array of #OstreeCollectionRef instances, designed to
be used with g_auto():
|[<!-- language="C" -->
g_auto(OstreeCollectionRefv) refs = NULL;
]|
-
+
A %NULL-terminated array of #OstreeRepoFinderResult instances, designed to
+ line="169">A %NULL-terminated array of #OstreeRepoFinderResult instances, designed to
be used with g_auto():
|[<!-- language="C" -->
g_auto(OstreeRepoFinderResultv) results = NULL;
]|
-
+
-
+
@@ -49,7 +49,7 @@ g_auto(OstreeRepoFinderResultv) results = NULL;
-
+
@@ -58,7 +58,7 @@ g_auto(OstreeRepoFinderResultv) results = NULL;
-
+
@@ -71,19 +71,19 @@ g_auto(OstreeRepoFinderResultv) results = NULL;
glib:type-name="OstreeAsyncProgress"
glib:get-type="ostree_async_progress_get_type"
glib:type-struct="AsyncProgressClass">
-
+
-
+
A new progress object
+ line="462">A new progress object
-
+
@@ -103,7 +103,7 @@ g_auto(OstreeRepoFinderResultv) results = NULL;
-
+
@@ -125,10 +125,10 @@ g_auto(OstreeRepoFinderResultv) results = NULL;
version="2019.6">
Atomically copies all the state from @self to @dest, without invoking the
+ line="425">Atomically copies all the state from @self to @dest, without invoking the
callback.
This is used for proxying progress objects across different #GMainContexts.
-
+
@@ -136,13 +136,13 @@ This is used for proxying progress objects across different #GMainContexts.
An #OstreeAsyncProgress to copy from
+ line="427">An #OstreeAsyncProgress to copy from
An #OstreeAsyncProgress to copy to
+ line="428">An #OstreeAsyncProgress to copy to
@@ -150,10 +150,10 @@ This is used for proxying progress objects across different #GMainContexts.
Process any pending signals, ensuring the main context is cleared
+ line="480">Process any pending signals, ensuring the main context is cleared
of sources used by this object. Also ensures that no further
events will be queued.
-
+
@@ -161,7 +161,7 @@ events will be queued.
Self
+ line="482">Self
@@ -172,7 +172,7 @@ events will be queued.
introspectable="0">
Get the values corresponding to zero or more keys from the
+ line="161">Get the values corresponding to zero or more keys from the
#OstreeAsyncProgress. Each key is specified in @... as the key name, followed
by a #GVariant format string, followed by the necessary arguments for that
format string, just as for g_variant_get(). After those arguments is the
@@ -197,7 +197,7 @@ ostree_async_progress_get (progress,
"refs", "@a{ss}", &refs_variant,
NULL);
]|
-
+
@@ -205,13 +205,13 @@ ostree_async_progress_get (progress,
an #OstreeAsyncProgress
+ line="163">an #OstreeAsyncProgress
key name, format string, #GVariant return locations, …, followed by %NULL
+ line="164">key name, format string, #GVariant return locations, …, followed by %NULL
@@ -221,29 +221,29 @@ ostree_async_progress_get (progress,
version="2017.6">
Get the human-readable status string from the #OstreeAsyncProgress. This
+ line="267">Get the human-readable status string from the #OstreeAsyncProgress. This
operation is thread-safe. The retuned value may be %NULL if no status is
set.
This is a convenience function to get the well-known `status` key.
-
+
the current status, or %NULL if none is set
+ line="277">the current status, or %NULL if none is set
an #OstreeAsyncProgress
+ line="269">an #OstreeAsyncProgress
-
+
@@ -258,7 +258,7 @@ This is a convenience function to get the well-known `status` key.
-
+
@@ -276,13 +276,13 @@ This is a convenience function to get the well-known `status` key.
version="2017.6">
Look up a key in the #OstreeAsyncProgress and return the #GVariant associated
+ line="115">Look up a key in the #OstreeAsyncProgress and return the #GVariant associated
with it. The lookup is thread-safe.
-
+
value for the given @key, or %NULL if
+ line="123">value for the given @key, or %NULL if
it was not set
@@ -290,13 +290,13 @@ with it. The lookup is thread-safe.
an #OstreeAsyncProgress
+ line="117">an #OstreeAsyncProgress
a key to look up
+ line="118">a key to look up
@@ -307,7 +307,7 @@ with it. The lookup is thread-safe.
introspectable="0">
Set the values for zero or more keys in the #OstreeAsyncProgress. Each key is
+ line="290">Set the values for zero or more keys in the #OstreeAsyncProgress. Each key is
specified in @... as the key name, followed by a #GVariant format string,
followed by the necessary arguments for that format string, just as for
g_variant_new(). After those arguments is the next key name. The varargs list
@@ -329,7 +329,7 @@ ostree_async_progress_set (progress,
"refs", "@a{ss}", g_variant_new_parsed ("@a{ss} {}"),
NULL);
]|
-
+
@@ -337,13 +337,13 @@ ostree_async_progress_set (progress,
an #OstreeAsyncProgress
+ line="292">an #OstreeAsyncProgress
key name, format string, #GVariant parameters, …, followed by %NULL
+ line="293">key name, format string, #GVariant parameters, …, followed by %NULL
@@ -353,11 +353,11 @@ ostree_async_progress_set (progress,
version="2017.6">
Set the human-readable status string for the #OstreeAsyncProgress. This
+ line="247">Set the human-readable status string for the #OstreeAsyncProgress. This
operation is thread-safe. %NULL may be passed to clear the status.
This is a convenience function to set the well-known `status` key.
-
+
@@ -365,7 +365,7 @@ This is a convenience function to set the well-known `status` key.
an #OstreeAsyncProgress
+ line="249">an #OstreeAsyncProgress
allow-none="1">
new status string, or %NULL to clear the status
+ line="250">new status string, or %NULL to clear the status
-
+
@@ -398,7 +398,7 @@ This is a convenience function to set the well-known `status` key.
-
+
@@ -419,13 +419,13 @@ This is a convenience function to set the well-known `status` key.
version="2017.6">
Assign a new @value to the given @key, replacing any existing value. The
+ line="364">Assign a new @value to the given @key, replacing any existing value. The
operation is thread-safe. @value may be a floating reference;
g_variant_ref_sink() will be called on it.
Any watchers of the #OstreeAsyncProgress will be notified of the change if
@value differs from the existing value for @key.
-
+
@@ -433,19 +433,19 @@ Any watchers of the #OstreeAsyncProgress will be notified of the change if
an #OstreeAsyncProgress
+ line="366">an #OstreeAsyncProgress
a key to set
+ line="367">a key to set
the value to assign to @key
+ line="368">the value to assign to @key
@@ -453,7 +453,7 @@ Any watchers of the #OstreeAsyncProgress will be notified of the change if
Emitted when @self has been changed.
+ line="91">Emitted when @self has been changed.
@@ -462,13 +462,13 @@ Any watchers of the #OstreeAsyncProgress will be notified of the change if
-
+
-
+
@@ -490,7 +490,7 @@ Any watchers of the #OstreeAsyncProgress will be notified of the change if
-
+
@@ -499,7 +499,7 @@ Any watchers of the #OstreeAsyncProgress will be notified of the change if
-
+
@@ -508,7 +508,7 @@ Any watchers of the #OstreeAsyncProgress will be notified of the change if
-
+
@@ -517,7 +517,7 @@ Any watchers of the #OstreeAsyncProgress will be notified of the change if
-
+
@@ -526,7 +526,7 @@ Any watchers of the #OstreeAsyncProgress will be notified of the change if
-
+
@@ -535,7 +535,7 @@ Any watchers of the #OstreeAsyncProgress will be notified of the change if
-
+
@@ -544,21 +544,21 @@ Any watchers of the #OstreeAsyncProgress will be notified of the change if
-
+
Whitespace separated set of features this libostree was configured with at build time.
+ line="93">Whitespace separated set of features this libostree was configured with at build time.
Consult the source code in configure.ac (or the CLI `ostree --version`) for examples.
-
+
-
+
-
+
Copy of @self
+ line="44">Copy of @self
Bootconfig to clone
+ line="42">Bootconfig to clone
-
+
@@ -607,11 +607,11 @@ Consult the source code in configure.ac (or the CLI `ostree --version`) for exam
-
+
Array of initrds or %NULL
+ line="176">Array of initrds or %NULL
if none are set.
@@ -621,7 +621,7 @@ if none are set.
Parser
+ line="174">Parser
@@ -629,7 +629,7 @@ if none are set.
-
+
@@ -653,8 +653,8 @@ if none are set.
throws="1">
Initialize a bootconfig from the given file.
-
+ line="59">Initialize a bootconfig from the given file.
+
@@ -662,19 +662,19 @@ if none are set.
Parser
+ line="61">Parser
Directory fd
+ line="62">Directory fd
File path
+ line="63">File path
allow-none="1">
Cancellable
+ line="64">Cancellable
-
+
@@ -710,9 +710,9 @@ if none are set.
version="2020.7">
These are rendered as additional `initrd` keys in the final bootloader configs. The
+ line="152">These are rendered as additional `initrd` keys in the final bootloader configs. The
base initrd is part of the primary keys.
-
+
@@ -720,7 +720,7 @@ base initrd is part of the primary keys.
Parser
+ line="154">Parser
allow-none="1">
Array of overlay
+ line="155">Array of overlay
initrds or %NULL to unset.
@@ -740,7 +740,7 @@ base initrd is part of the primary keys.
-
+
@@ -762,7 +762,7 @@ base initrd is part of the primary keys.
-
+
@@ -786,21 +786,21 @@ base initrd is part of the primary keys.
-
+
-
+
-
+
-
+
@@ -819,7 +819,7 @@ base initrd is part of the primary keys.
-
+
@@ -832,7 +832,7 @@ base initrd is part of the primary keys.
-
+
@@ -856,7 +856,7 @@ base initrd is part of the primary keys.
-
+
@@ -864,6 +864,9 @@ base initrd is part of the primary keys.
+
+
+
@@ -872,7 +875,7 @@ base initrd is part of the primary keys.
-
+
@@ -887,20 +890,20 @@ base initrd is part of the primary keys.
-
+
-
+
-
+
-
+
@@ -909,7 +912,7 @@ base initrd is part of the primary keys.
-
+
@@ -918,7 +921,7 @@ base initrd is part of the primary keys.
-
+
@@ -930,26 +933,26 @@ base initrd is part of the primary keys.
introspectable="0">
Compile-time version checking. Evaluates to %TRUE if the version
+ line="79">Compile-time version checking. Evaluates to %TRUE if the version
of ostree is equal or greater than the required one.
-
+
required year version
+ line="81">required year version
required release version
+ line="82">required release version
-
+
version="2020.4">
GVariant type `s`. Intended to describe the CPU architecture. This is a freeform string, and some distributions
+ line="222">GVariant type `s`. Intended to describe the CPU architecture. This is a freeform string, and some distributions
which have existing package managers might want to match that schema. If you
don't have a prior schema, it's recommended to use `uname -m` by default (i.e. the Linux kernel schema). In the future
ostree might include a builtin function to compare architectures.
-
+
version="2018.6">
GVariant type `s`. If this is added to a commit, `ostree_repo_pull()`
+ line="284">GVariant type `s`. If this is added to a commit, `ostree_repo_pull()`
will enforce that the commit was retrieved from a repository which has
the same collection ID. See `ostree_repo_set_collection_id()`.
This is most useful in concert with `OSTREE_COMMIT_META_KEY_REF_BINDING`,
as it more strongly binds the commit to the repository and branch.
-
+
version="2017.7">
GVariant type `s`. This metadata key is used to display vendor's message
+ line="244">GVariant type `s`. This metadata key is used to display vendor's message
when an update stream for a particular branch ends. It usually provides
update instructions for the users.
-
+
version="2017.7">
GVariant type `s`. Should contain a refspec defining a new target branch;
+ line="234">GVariant type `s`. Should contain a refspec defining a new target branch;
`ostree admin upgrade` and `OstreeSysrootUpgrader` will automatically initiate
a rebase upon encountering this metadata key.
-
+
version="2017.9">
GVariant type `as`; each element is a branch name. If this is added to a
+ line="271">GVariant type `as`; each element is a branch name. If this is added to a
commit, `ostree_repo_pull()` will enforce that the commit was retrieved from
one of the branch names in this array. This prevents "sidegrade" attacks.
The rationale for having this support multiple branch names is that it helps
support a "promotion" model of taking a commit and moving it between development
and production branches.
-
+
version="2017.13">
GVariant type `s`. This should hold a relatively short single line value
+ line="254">GVariant type `s`. This should hold a relatively short single line value
containing a human-readable "source" for a commit, intended to be displayed
near the origin ref. This is particularly useful for systems that inject
content into an OSTree commit from elsewhere - for example, generating from
@@ -1033,7 +1036,7 @@ names and their versions.
Try to keep this key short (e.g. < 80 characters) and human-readable; if you
desire machine readable data, consider injecting separate metadata keys.
-
+
version="2014.9">
GVariant type `s`. This metadata key is used for version numbers. A freeform
+ line="210">GVariant type `s`. This metadata key is used for version numbers. A freeform
string; the intention is that systems using ostree do not interpret this
semantically as traditional package managers do.
This is the only ostree-defined metadata key that does not start with `ostree.`.
-
+
Flags influencing checksumming logic.
-
+ line="467">Flags influencing checksumming logic.
+
Default checksumming without tweaks.
+ line="469">Default checksumming without tweaks.
(Since: 2017.13.)
Ignore xattrs when checksumming.
+ line="471">Ignore xattrs when checksumming.
(Since: 2017.13.)
Use canonical uid/gid/mode
+ line="473">Use canonical uid/gid/mode
values, for bare-user-only mode. (Since: 2021.4.)
@@ -1087,9 +1090,9 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
glib:type-name="OstreeChecksumInputStream"
glib:get-type="ostree_checksum_input_stream_get_type"
glib:type-struct="ChecksumInputStreamClass">
-
+
-
+
@@ -1120,7 +1123,7 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
-
+
@@ -1128,7 +1131,7 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
+ line="52"/>
@@ -1137,7 +1140,7 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
+ line="53"/>
@@ -1146,7 +1149,7 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
+ line="54"/>
@@ -1155,7 +1158,7 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
+ line="55"/>
@@ -1164,7 +1167,7 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
+ line="56"/>
@@ -1174,13 +1177,13 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
-
+
-
+
-
+
@@ -1202,7 +1205,7 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
-
+
@@ -1224,7 +1227,7 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
-
+
@@ -1243,7 +1246,7 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
-
+
@@ -1265,7 +1268,7 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
-
+
@@ -1284,7 +1287,7 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
-
+
@@ -1303,7 +1306,7 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
-
+
@@ -1326,21 +1329,21 @@ This is the only ostree-defined metadata key that does not start with `ostree.`.
c:symbol-prefix="collection_ref">
A structure which globally uniquely identifies a ref as the tuple
+ line="33">A structure which globally uniquely identifies a ref as the tuple
(@collection_id, @ref_name). For backwards compatibility, @collection_id may be %NULL,
indicating a ref name which is not globally unique.
-
+
collection ID which provided the ref, or %NULL if there
+ line="35">collection ID which provided the ref, or %NULL if there
is no associated collection
ref name
+ line="37">ref name
version="2018.6">
Create a new #OstreeCollectionRef containing (@collection_id, @ref_name). If
+ line="38">Create a new #OstreeCollectionRef containing (@collection_id, @ref_name). If
@collection_id is %NULL, this is equivalent to a plain ref name string (not a
refspec; no remote name is included), which can be used for non-P2P
operations.
-
+
a new #OstreeCollectionRef
+ line="48">a new #OstreeCollectionRef
@@ -1366,13 +1369,13 @@ operations.
allow-none="1">
a collection ID, or %NULL for a plain ref
+ line="40">a collection ID, or %NULL for a plain ref
a ref name
+ line="41">a ref name
@@ -1382,19 +1385,19 @@ operations.
version="2018.6">
Create a copy of the given @ref.
-
+ line="68">Create a copy of the given @ref.
+
a newly allocated copy of @ref
+ line="74">a newly allocated copy of @ref
an #OstreeCollectionRef
+ line="70">an #OstreeCollectionRef
@@ -1404,8 +1407,8 @@ operations.
version="2018.6">
Free the given @ref.
-
+ line="85">Free the given @ref.
+
@@ -1413,7 +1416,7 @@ operations.
an #OstreeCollectionRef
+ line="87">an #OstreeCollectionRef
@@ -1423,14 +1426,14 @@ operations.
version="2018.6">
Copy an array of #OstreeCollectionRefs, including deep copies of all its
+ line="145">Copy an array of #OstreeCollectionRefs, including deep copies of all its
elements. @refs must be %NULL-terminated; it may be empty, but must not be
%NULL.
-
+
a newly allocated copy of @refs
+ line="153">a newly allocated copy of @refs
@@ -1439,7 +1442,7 @@ elements. @refs must be %NULL-terminated; it may be empty, but must not be
%NULL-terminated array of #OstreeCollectionRefs
+ line="147">%NULL-terminated array of #OstreeCollectionRefs
@@ -1451,26 +1454,26 @@ elements. @refs must be %NULL-terminated; it may be empty, but must not be
version="2018.6">
Compare @ref1 and @ref2 and return %TRUE if they have the same collection ID and
+ line="124">Compare @ref1 and @ref2 and return %TRUE if they have the same collection ID and
ref name, and %FALSE otherwise. Both @ref1 and @ref2 must be non-%NULL.
-
+
%TRUE if @ref1 and @ref2 are equal, %FALSE otherwise
+ line="132">%TRUE if @ref1 and @ref2 are equal, %FALSE otherwise
an #OstreeCollectionRef
+ line="126">an #OstreeCollectionRef
another #OstreeCollectionRef
+ line="127">another #OstreeCollectionRef
@@ -1480,9 +1483,9 @@ ref name, and %FALSE otherwise. Both @ref1 and @ref2 must be non-%NULL.
version="2018.6">
Free the given array of @refs, including freeing all its elements. @refs
+ line="173">Free the given array of @refs, including freeing all its elements. @refs
must be %NULL-terminated; it may be empty, but must not be %NULL.
-
+
@@ -1490,7 +1493,7 @@ must be %NULL-terminated; it may be empty, but must not be %NULL.
an array of #OstreeCollectionRefs
+ line="175">an array of #OstreeCollectionRefs
@@ -1502,20 +1505,20 @@ must be %NULL-terminated; it may be empty, but must not be %NULL.
version="2018.6">
Hash the given @ref. This function is suitable for use with #GHashTable.
+ line="103">Hash the given @ref. This function is suitable for use with #GHashTable.
@ref must be non-%NULL.
-
+
hash value for @ref
+ line="110">hash value for @ref
an #OstreeCollectionRef
+ line="105">an #OstreeCollectionRef
@@ -1529,31 +1532,31 @@ must be %NULL-terminated; it may be empty, but must not be %NULL.
c:symbol-prefix="commit_sizes_entry">
Structure representing an entry in the "ostree.sizes" commit metadata. Each
+ line="552">Structure representing an entry in the "ostree.sizes" commit metadata. Each
entry corresponds to an object in the associated commit.
-
+
object checksum
+ line="554">object checksum
object type
+ line="555">object type
unpacked object size
+ line="556">unpacked object size
compressed object size
+ line="557">compressed object size
version="2020.1">
Create a new #OstreeCommitSizesEntry for representing an object in a
+ line="2471">Create a new #OstreeCommitSizesEntry for representing an object in a
commit's "ostree.sizes" metadata.
-
+
a new #OstreeCommitSizesEntry
+ line="2481">a new #OstreeCommitSizesEntry
object checksum
+ line="2473">object checksum
object type
+ line="2474">object type
unpacked object size
+ line="2475">unpacked object size
compressed object size
+ line="2476">compressed object size
@@ -1602,19 +1605,19 @@ commit's "ostree.sizes" metadata.
version="2020.1">
Create a copy of the given @entry.
-
+ line="2501">Create a copy of the given @entry.
+
a new copy of @entry
+ line="2507">a new copy of @entry
an #OstreeCommitSizesEntry
+ line="2503">an #OstreeCommitSizesEntry
@@ -1625,8 +1628,8 @@ commit's "ostree.sizes" metadata.
version="2020.1">
Free given @entry.
-
+ line="2521">Free given @entry.
+
@@ -1634,7 +1637,7 @@ commit's "ostree.sizes" metadata.
an #OstreeCommitSizesEntry
+ line="2523">an #OstreeCommitSizesEntry
@@ -1647,25 +1650,25 @@ commit's "ostree.sizes" metadata.
glib:type-name="OstreeContentWriter"
glib:get-type="ostree_content_writer_get_type"
glib:type-struct="ContentWriterClass">
-
+
Complete the object write and return the checksum.
-
+ line="122">Complete the object write and return the checksum.
+
Checksum, or %NULL on error
+ line="129">Checksum, or %NULL on error
Writer
+ line="124">Writer
allow-none="1">
Cancellable
+ line="125">Cancellable
@@ -1683,7 +1686,7 @@ commit's "ostree.sizes" metadata.
-
+
@@ -1691,7 +1694,7 @@ commit's "ostree.sizes" metadata.
-
+
@@ -1700,7 +1703,7 @@ commit's "ostree.sizes" metadata.
-
+
glib:type-name="OstreeDeployment"
glib:get-type="ostree_deployment_get_type">
-
+
New deployment
+ line="362">New deployment
Global index into the bootloader entries
+ line="355">Global index into the bootloader entries
"stateroot" for this deployment
+ line="356">"stateroot" for this deployment
OSTree commit that will be deployed
+ line="357">OSTree commit that will be deployed
Unique counter
+ line="358">Unique counter
allow-none="1">
Kernel/initrd checksum
+ line="359">Kernel/initrd checksum
Unique index
+ line="360">Unique index
@@ -1764,7 +1767,7 @@ commit's "ostree.sizes" metadata.
version="2018.3">
The intention of an origin file is primarily describe the "inputs" that
+ line="181">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
@@ -1778,7 +1781,7 @@ software.
Additionally, this function will remove the `origin/unlocked` and
`origin/override-commit` members; these should be considered transient state
that should have been under an explicit group.
-
+
@@ -1786,7 +1789,7 @@ that should have been under an explicit group.
An origin
+ line="183">An origin
@@ -1794,11 +1797,11 @@ that should have been under an explicit group.
-
+
Description of state
+ line="414">Description of state
@@ -1809,66 +1812,66 @@ that should have been under an explicit group.
-
+
New deep copy of @self
+ line="250">New deep copy of @self
Deployment
+ line="248">Deployment
-
+
%TRUE if deployments have the same osname, csum, and deployserial
+ line="304">%TRUE if deployments have the same osname, csum, and deployserial
A deployment
+ line="301">A deployment
A deployment
+ line="302">A deployment
-
+
Boot configuration
+ line="92">Boot configuration
Deployment
+ line="90">Deployment
-
+
@@ -1880,7 +1883,7 @@ that should have been under an explicit group.
-
+
@@ -1891,7 +1894,7 @@ that should have been under an explicit group.
-
+
@@ -1903,7 +1906,7 @@ that should have been under an explicit group.
-
+
@@ -1914,35 +1917,35 @@ that should have been under an explicit group.
-
+
The global index into the bootloader ordering
+ line="116">The global index into the bootloader ordering
Deployment
+ line="114">Deployment
-
+
Origin
+ line="104">Origin
Deployment
+ line="102">Deployment
@@ -1951,27 +1954,27 @@ 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="392">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="400">Path to deployment root directory, relative to sysroot
A deployment
+ line="394">A deployment
-
+
@@ -1984,7 +1987,7 @@ or concatenate it with the full ostree_sysroot_get_path().
-
+
@@ -1996,18 +1999,18 @@ or concatenate it with the full ostree_sysroot_get_path().
-
+
An integer suitable for use in a `GHashTable`
+ line="288">An integer suitable for use in a `GHashTable`
Deployment
+ line="286">Deployment
@@ -2017,19 +2020,19 @@ or concatenate it with the full ostree_sysroot_get_path().
version="2018.3">
See ostree_sysroot_deployment_set_pinned().
-
+ line="445">See ostree_sysroot_deployment_set_pinned().
+
`TRUE` if deployment will not be subject to GC
+ line="451">`TRUE` if deployment will not be subject to GC
Deployment
+ line="447">Deployment
@@ -2037,18 +2040,18 @@ or concatenate it with the full ostree_sysroot_get_path().
-
+
`TRUE` if deployment should be "finalized" at shutdown time
+ line="466">`TRUE` if deployment should be "finalized" at shutdown time
Deployment
+ line="464">Deployment
@@ -2057,34 +2060,7 @@ or concatenate it with the full ostree_sysroot_get_path().
c:identifier="ostree_deployment_set_bootconfig">
Set or clear the bootloader configuration.
-
-
-
-
-
-
- Deployment
-
-
-
- Bootloader configuration object
-
-
-
-
-
- Should never have been made public API; don't use this.
+ line="150">Set or clear the bootloader configuration.
@@ -2093,21 +2069,25 @@ or concatenate it with the full ostree_sysroot_get_path().
Deployment
+ line="152">Deployment
-
+
Don't use this
-
+ line="153">Bootloader configuration object
+
-
+
Sets the global index into the bootloader ordering.
+ line="137">Should never have been made public API; don't use this.
@@ -2116,23 +2096,22 @@ or concatenate it with the full ostree_sysroot_get_path().
Deployment
+ line="139">Deployment
Index into bootloader ordering
+ line="140">Don't use this
-
+
Replace the "origin", which is a description of the source
-of the deployment and how to update to the next version.
-
+ line="124">Sets the global index into the bootloader ordering.
+
@@ -2140,7 +2119,31 @@ of the deployment and how to update to the next version.
Deployment
+ line="126">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
allow-none="1">
Set the origin for this deployment
+ line="168">Set the origin for this deployment
@@ -2157,7 +2160,7 @@ of the deployment and how to update to the next version.
-
+
@@ -2178,10 +2181,10 @@ of the deployment and how to update to the next version.
An extensible options structure controlling diff dirs. Make sure
+ line="73">An extensible options structure controlling diff dirs. Make sure
that owner_uid/gid is set to -1 when not used. This is used by
ostree_diff_dirs_with_options().
-
+
@@ -2208,7 +2211,7 @@ ostree_diff_dirs_with_options().
-
+
glib:type-name="OstreeDiffItem"
glib:get-type="ostree_diff_item_get_type"
c:symbol-prefix="diff_item">
-
+
@@ -2244,7 +2247,7 @@ ostree_diff_dirs_with_options().
-
+
@@ -2255,7 +2258,7 @@ ostree_diff_dirs_with_options().
-
+
@@ -2269,7 +2272,7 @@ ostree_diff_dirs_with_options().
-
+
@@ -2280,19 +2283,19 @@ ostree_diff_dirs_with_options().
-
+
-
+
-
+
@@ -2301,7 +2304,7 @@ ostree_diff_dirs_with_options().
-
+
@@ -2313,43 +2316,43 @@ ostree_diff_dirs_with_options().
glib:error-domain="OstreeGpgError">
Errors returned by signature creation and verification operations in OSTree.
+ line="155">Errors returned by signature creation and verification operations in OSTree.
These may be returned by any API which creates or verifies signatures.
-
+
A signature was expected, but not found.
+ line="157">A signature was expected, but not found.
A signature was malformed.
+ line="158">A signature was malformed.
A signature was found, but was created with a key not in the configured keyrings.
+ line="159">A signature was found, but was created with a key not in the configured keyrings.
A signature was expired. Since: 2020.1.
+ line="160">A signature was expired. Since: 2020.1.
A signature was found, but the key used to
+ line="161">A signature was found, but the key used to
sign it has expired. Since: 2020.1.
c:identifier="OSTREE_GPG_ERROR_REVOKED_KEY">
A signature was found, but the key used to
+ line="163">A signature was found, but the key used to
sign it has been revoked. Since: 2020.1.
Signature attributes available from an #OstreeGpgVerifyResult.
+ line="36">Signature attributes available from an #OstreeGpgVerifyResult.
The attribute's #GVariantType is shown in brackets.
-
+
[#G_VARIANT_TYPE_BOOLEAN] Is the signature valid?
+ line="38">[#G_VARIANT_TYPE_BOOLEAN] Is the signature valid?
[#G_VARIANT_TYPE_BOOLEAN] Has the signature expired?
+ line="40">[#G_VARIANT_TYPE_BOOLEAN] Has the signature expired?
[#G_VARIANT_TYPE_BOOLEAN] Has the signing key expired?
+ line="42">[#G_VARIANT_TYPE_BOOLEAN] Has the signing key expired?
[#G_VARIANT_TYPE_BOOLEAN] Has the signing key been revoked?
+ line="44">[#G_VARIANT_TYPE_BOOLEAN] Has the signing key been revoked?
[#G_VARIANT_TYPE_BOOLEAN] Is the signing key missing?
+ line="46">[#G_VARIANT_TYPE_BOOLEAN] Is the signing key missing?
[#G_VARIANT_TYPE_STRING] Fingerprint of the signing key
+ line="48">[#G_VARIANT_TYPE_STRING] Fingerprint of the signing key
[#G_VARIANT_TYPE_INT64] Signature creation Unix timestamp
+ line="50">[#G_VARIANT_TYPE_INT64] Signature creation Unix timestamp
[#G_VARIANT_TYPE_INT64] Signature expiration Unix timestamp (0 if no
+ line="52">[#G_VARIANT_TYPE_INT64] Signature expiration Unix timestamp (0 if no
expiration)
c:identifier="OSTREE_GPG_SIGNATURE_ATTR_PUBKEY_ALGO_NAME">
[#G_VARIANT_TYPE_STRING] Name of the public key algorithm used to create
+ line="55">[#G_VARIANT_TYPE_STRING] Name of the public key algorithm used to create
the signature
c:identifier="OSTREE_GPG_SIGNATURE_ATTR_HASH_ALGO_NAME">
[#G_VARIANT_TYPE_STRING] Name of the hash algorithm used to create the
+ line="58">[#G_VARIANT_TYPE_STRING] Name of the hash algorithm used to create the
signature
c:identifier="OSTREE_GPG_SIGNATURE_ATTR_USER_NAME">
[#G_VARIANT_TYPE_STRING] The name of the signing key's primary user
+ line="61">[#G_VARIANT_TYPE_STRING] The name of the signing key's primary user
[#G_VARIANT_TYPE_STRING] The email address of the signing key's primary
+ line="63">[#G_VARIANT_TYPE_STRING] The email address of the signing key's primary
user
c:identifier="OSTREE_GPG_SIGNATURE_ATTR_FINGERPRINT_PRIMARY">
[#G_VARIANT_TYPE_STRING] Fingerprint of the signing key's primary key
+ line="66">[#G_VARIANT_TYPE_STRING] Fingerprint of the signing key's primary key
(will be the same as OSTREE_GPG_SIGNATURE_ATTR_FINGERPRINT if the
the signature is already from the primary key rather than a subkey,
and will be the empty string if the key is missing.)
@@ -2470,7 +2473,7 @@ The attribute's #GVariantType is shown in brackets.
c:identifier="OSTREE_GPG_SIGNATURE_ATTR_KEY_EXP_TIMESTAMP">
[#G_VARIANT_TYPE_INT64] Key expiration Unix timestamp (0 if no
+ line="71">[#G_VARIANT_TYPE_INT64] Key expiration Unix timestamp (0 if no
expiration or if the key is missing)
c:identifier="OSTREE_GPG_SIGNATURE_ATTR_KEY_EXP_TIMESTAMP_PRIMARY">
[#G_VARIANT_TYPE_INT64] Key expiration Unix timestamp of the signing key's
+ line="74">[#G_VARIANT_TYPE_INT64] Key expiration Unix timestamp of the signing key's
primary key (will be the same as OSTREE_GPG_SIGNATURE_ATTR_KEY_EXP_TIMESTAMP
if the signing key is the primary key and 0 if no expiration or if the key
is missing)
@@ -2488,20 +2491,20 @@ The attribute's #GVariantType is shown in brackets.
c:type="OstreeGpgSignatureFormatFlags">
Formatting flags for ostree_gpg_verify_result_describe(). Currently
+ line="125">Formatting flags for ostree_gpg_verify_result_describe(). Currently
there's only one possible output format, but this enumeration allows
for future variations.
-
+
Use the default output format
+ line="127">Use the default output format
-
+
c:identifier="ostree_gpg_verify_result_describe_variant">
Similar to ostree_gpg_verify_result_describe() but takes a #GVariant of
+ line="581">Similar to ostree_gpg_verify_result_describe() but takes a #GVariant of
all attributes for a GPG signature instead of an #OstreeGpgVerifyResult
and signature index.
The @variant <emphasis>MUST</emphasis> have been created by
ostree_gpg_verify_result_get_all().
-
+
@@ -2528,13 +2531,13 @@ ostree_gpg_verify_result_get_all().
a #GVariant from ostree_gpg_verify_result_get_all()
+ line="583">a #GVariant from ostree_gpg_verify_result_get_all()
a #GString to hold the description
+ line="584">a #GString to hold the description
allow-none="1">
optional line prefix string
+ line="585">optional line prefix string
flags to adjust the description format
+ line="586">flags to adjust the description format
@@ -2559,19 +2562,19 @@ ostree_gpg_verify_result_get_all().
c:identifier="ostree_gpg_verify_result_count_all">
Counts all the signatures in @result.
-
+ line="168">Counts all the signatures in @result.
+
signature count
+ line="174">signature count
an #OstreeGpgVerifyResult
+ line="170">an #OstreeGpgVerifyResult
@@ -2580,19 +2583,19 @@ ostree_gpg_verify_result_get_all().
c:identifier="ostree_gpg_verify_result_count_valid">
Counts only the valid signatures in @result.
-
+ line="194">Counts only the valid signatures in @result.
+
valid signature count
+ line="200">valid signature count
an #OstreeGpgVerifyResult
+ line="196">an #OstreeGpgVerifyResult
@@ -2600,7 +2603,7 @@ ostree_gpg_verify_result_get_all().
Appends a brief, human-readable description of the GPG signature at
+ line="506">Appends a brief, human-readable description of the GPG signature at
@signature_index in @result to the @output_buffer. The description
spans multiple lines. A @line_prefix string, if given, will precede
each line of the description.
@@ -2611,7 +2614,7 @@ format. Currently must be 0.
It is a programmer error to request an invalid @signature_index. Use
ostree_gpg_verify_result_count_all() to find the number of signatures in
@result.
-
+
@@ -2619,19 +2622,19 @@ ostree_gpg_verify_result_count_all() to find the number of signatures in
an #OstreeGpgVerifyResult
+ line="508">an #OstreeGpgVerifyResult
which signature to describe
+ line="509">which signature to describe
a #GString to hold the description
+ line="510">a #GString to hold the description
optional line prefix string
+ line="511">optional line prefix string
flags to adjust the description format
+ line="512">flags to adjust the description format
@@ -2655,37 +2658,37 @@ ostree_gpg_verify_result_count_all() to find the number of signatures in
Builds a #GVariant tuple of requested attributes for the GPG signature at
+ line="286">Builds a #GVariant tuple of requested attributes for the GPG signature at
@signature_index in @result. See the #OstreeGpgSignatureAttr description
for the #GVariantType of each available attribute.
It is a programmer error to request an invalid #OstreeGpgSignatureAttr or
an invalid @signature_index. Use ostree_gpg_verify_result_count_all() to
find the number of signatures in @result.
-
-
+
+
a new, floating, #GVariant tuple
+ line="301">a new, floating, #GVariant tuple
an #OstreeGpgVerifyResult
+ line="288">an #OstreeGpgVerifyResult
which signature to get attributes from
+ line="289">which signature to get attributes from
Array of requested attributes
+ line="290">Array of requested attributes
@@ -2695,7 +2698,7 @@ find the number of signatures in @result.
Length of the @attrs array
+ line="291">Length of the @attrs array
@@ -2703,7 +2706,7 @@ find the number of signatures in @result.
Builds a #GVariant tuple of all available attributes for the GPG signature
+ line="464">Builds a #GVariant tuple of all available attributes for the GPG signature
at @signature_index in @result.
The child values in the returned #GVariant tuple are ordered to match the
@@ -2726,24 +2729,24 @@ available attribute.
It is a programmer error to request an invalid @signature_index. Use
ostree_gpg_verify_result_count_all() to find the number of signatures in
@result.
-
-
+
+
a new, floating, #GVariant tuple
+ line="493">a new, floating, #GVariant tuple
an #OstreeGpgVerifyResult
+ line="466">an #OstreeGpgVerifyResult
which signature to get attributes from
+ line="467">which signature to get attributes from
@@ -2751,29 +2754,29 @@ ostree_gpg_verify_result_count_all() to find the number of signatures in
Searches @result for a signature signed by @key_id. If a match is found,
+ line="221">Searches @result for a signature signed by @key_id. If a match is found,
the function returns %TRUE and sets @out_signature_index so that further
signature details can be obtained through ostree_gpg_verify_result_get().
If no match is found, the function returns %FALSE and leaves
@out_signature_index unchanged.
-
+
%TRUE on success, %FALSE on failure
+ line="234">%TRUE on success, %FALSE on failure
an #OstreeGpgVerifyResult
+ line="223">an #OstreeGpgVerifyResult
a GPG key ID or fingerprint
+ line="224">a GPG key ID or fingerprint
return location for the index of the signature
+ line="225">return location for the index of the signature
signed by @key_id, or %NULL
@@ -2794,15 +2797,15 @@ If no match is found, the function returns %FALSE and leaves
throws="1">
Checks if the result contains at least one signature from the
+ line="746">Checks if the result contains at least one signature from the
trusted keyring. You can call this function immediately after
ostree_repo_verify_summary() or ostree_repo_verify_commit_ext() -
it will handle the %NULL @result and filled @error too.
-
+
%TRUE if @result was not %NULL and had at least one
+ line="756">%TRUE if @result was not %NULL and had at least one
signature from trusted keyring, otherwise %FALSE
@@ -2813,7 +2816,7 @@ signature from trusted keyring, otherwise %FALSE
allow-none="1">
an #OstreeGpgVerifyResult
+ line="748">an #OstreeGpgVerifyResult
@@ -2822,7 +2825,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2831,7 +2834,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2840,7 +2843,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2849,7 +2852,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2858,7 +2861,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2867,7 +2870,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2876,7 +2879,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2885,7 +2888,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2894,7 +2897,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2903,7 +2906,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2912,7 +2915,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2921,7 +2924,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2930,7 +2933,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2939,7 +2942,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2948,7 +2951,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -2993,7 +2996,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -3002,7 +3005,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -3011,7 +3014,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -3020,7 +3023,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -3029,7 +3032,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -3038,7 +3041,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -3047,7 +3050,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -3056,7 +3059,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -3065,7 +3068,7 @@ signature from trusted keyring, otherwise %FALSE
-
+
@@ -3074,23 +3077,23 @@ signature from trusted keyring, otherwise %FALSE
-
+
-
+
Appends @arg which is in the form of key=value pair to the hash table kargs->table
+ line="504">Appends @arg which is in the form of key=value pair to the hash table kargs->table
(appends to the value list if key is already in the hash table)
and appends key to kargs->order if it is not in the hash table already.
-
+
@@ -3098,13 +3101,13 @@ and appends key to kargs->order if it is not in the hash table already.
a OstreeKernelArgs instance
+ line="506">a OstreeKernelArgs instance
key or key/value pair to be added
+ line="507">key or key/value pair to be added
@@ -3114,9 +3117,9 @@ and appends key to kargs->order if it is not in the hash table already.
version="2019.3">
Appends each value in @argv to the corresponding value array and
+ line="592">Appends each value in @argv to the corresponding value array and
appends key to kargs->order if it is not in the hash table already.
-
+
@@ -3124,13 +3127,13 @@ appends key to kargs->order if it is not in the hash table already.
a OstreeKernelArgs instance
+ line="594">a OstreeKernelArgs instance
an array of key=value argument pairs
+ line="595">an array of key=value argument pairs
@@ -3140,8 +3143,8 @@ appends key to kargs->order if it is not in the hash table already.
version="2019.3">
Appends each argument that does not have one of the @prefixes as prefix to the @kargs
-
+ line="566">Appends each argument that does not have one of the @prefixes as prefix to the @kargs
+
@@ -3149,19 +3152,19 @@ appends key to kargs->order if it is not in the hash table already.
a OstreeKernelArgs instance
+ line="568">a OstreeKernelArgs instance
an array of key=value argument pairs
+ line="569">an array of key=value argument pairs
an array of prefix strings
+ line="570">an array of prefix strings
@@ -3172,20 +3175,20 @@ appends key to kargs->order if it is not in the hash table already.
throws="1">
Appends the command line arguments in the file "/proc/cmdline"
+ line="609">Appends the command line arguments in the file "/proc/cmdline"
that does not have "BOOT_IMAGE=" and "initrd=" as prefixes to the @kargs
-
+
%TRUE on success, %FALSE on failure
+ line="618">%TRUE on success, %FALSE on failure
a OstreeKernelArgs instance
+ line="611">a OstreeKernelArgs instance
allow-none="1">
optional GCancellable object, NULL to ignore
+ line="612">optional GCancellable object, NULL to ignore
@@ -3204,7 +3207,7 @@ that does not have "BOOT_IMAGE=" and "initrd=" as prefixes to the @kargs
throws="1">
There are few scenarios being handled for deletion:
+ line="370">There are few scenarios being handled for deletion:
1: for input arg with a single key(i.e without = for split),
the key/value pair will be deleted if there is only
@@ -3221,7 +3224,7 @@ that does not have "BOOT_IMAGE=" and "initrd=" as prefixes to the @kargs
Returns: %TRUE on success, %FALSE on failure
Since: 2019.3
-
+
@@ -3229,13 +3232,13 @@ that does not have "BOOT_IMAGE=" and "initrd=" as prefixes to the @kargs
a OstreeKernelArgs instance
+ line="372">a OstreeKernelArgs instance
key or key/value pair for deletion
+ line="373">key or key/value pair for deletion
@@ -3246,30 +3249,30 @@ that does not have "BOOT_IMAGE=" and "initrd=" as prefixes to the @kargs
throws="1">
This function removes the key entry from the hashtable
+ line="330">This function removes the key entry from the hashtable
as well from the order pointer array inside kargs
Note: since both table and order inside kernel args
are with free function, no extra free functions are
being called as they are done automatically by GLib
-
+
%TRUE on success, %FALSE on failure
+ line="343">%TRUE on success, %FALSE on failure
an OstreeKernelArgs instance
+ line="332">an OstreeKernelArgs instance
the key to remove
+ line="333">the key to remove
@@ -3279,8 +3282,8 @@ being called as they are done automatically by GLib
version="2019.3">
Frees the kargs structure
-
+ line="196">Frees the kargs structure
+
@@ -3288,7 +3291,7 @@ being called as they are done automatically by GLib
An OstreeKernelArgs that represents kernel arguments
+ line="198">An OstreeKernelArgs that represents kernel arguments
@@ -3298,14 +3301,14 @@ being called as they are done automatically by GLib
version="2019.3">
Finds and returns the last element of value array
+ line="781">Finds and returns the last element of value array
corresponding to the @key in @kargs hash table. Note that the application
will be terminated if the @key is found but the value array is empty
-
+
NULL if @key is not found in the @kargs hash table,
+ line="790">NULL if @key is not found in the @kargs hash table,
otherwise returns last element of value array corresponding to @key
@@ -3313,13 +3316,13 @@ otherwise returns last element of value array corresponding to @key
a OstreeKernelArgs instance
+ line="783">a OstreeKernelArgs instance
a key to look for in @kargs hash table
+ line="784">a key to look for in @kargs hash table
@@ -3330,7 +3333,7 @@ otherwise returns last element of value array corresponding to @key
throws="1">
This function implements the basic logic behind key/value pair
+ line="264">This function implements the basic logic behind key/value pair
replacement. Do note that the arg need to be properly formatted
When replacing key with exact one value, the arg can be in
@@ -3345,11 +3348,11 @@ key=old_val=new_val. Unless there is a special case where
there is an empty value associated with the key, then
key=new_val will work because old_val is empty. The empty
val will be swapped with the new_val in that case
-
+
%TRUE on success, %FALSE on failure (and in some other instances such as:
+ line="286">%TRUE on success, %FALSE on failure (and in some other instances such as:
1. key not found in @kargs
2. old value not found when @arg is in the form of key=old_val=new_val
3. multiple old values found when @arg is in the form of key=old_val)
@@ -3359,13 +3362,13 @@ val will be swapped with the new_val in that case
OstreeKernelArgs instance
+ line="266">OstreeKernelArgs instance
a string argument
+ line="267">a string argument
@@ -3375,8 +3378,8 @@ val will be swapped with the new_val in that case
version="2019.3">
Parses @options by separating it by whitespaces and appends each argument to @kargs
-
+ line="653">Parses @options by separating it by whitespaces and appends each argument to @kargs
+
@@ -3384,13 +3387,13 @@ val will be swapped with the new_val in that case
a OstreeKernelArgs instance
+ line="655">a OstreeKernelArgs instance
a string representing command line arguments
+ line="656">a string representing command line arguments
@@ -3400,10 +3403,10 @@ val will be swapped with the new_val in that case
version="2019.3">
Finds and replaces the old key if @arg is already in the hash table,
+ line="486">Finds and replaces the old key if @arg is already in the hash table,
otherwise adds @arg as new key and split_keyeq (arg) as value.
Note that when replacing old key value pair, the old values are freed.
-
+
@@ -3411,13 +3414,13 @@ Note that when replacing old key value pair, the old values are freed.
a OstreeKernelArgs instance
+ line="488">a OstreeKernelArgs instance
key or key/value pair for replacement
+ line="489">key or key/value pair for replacement
@@ -3427,10 +3430,10 @@ Note that when replacing old key value pair, the old values are freed.
version="2019.3">
Finds and replaces each non-null arguments of @argv in the hash table,
+ line="542">Finds and replaces each non-null arguments of @argv in the hash table,
otherwise adds individual arg as new key and split_keyeq (arg) as value.
Note that when replacing old key value pair, the old values are freed.
-
+
@@ -3438,13 +3441,13 @@ Note that when replacing old key value pair, the old values are freed.
a OstreeKernelArgs instance
+ line="544">a OstreeKernelArgs instance
an array of key or key/value pairs
+ line="545">an array of key or key/value pairs
@@ -3454,10 +3457,10 @@ Note that when replacing old key value pair, the old values are freed.
version="2019.3">
Finds and replaces the old key if @arg is already in the hash table,
+ line="435">Finds and replaces the old key if @arg is already in the hash table,
otherwise adds @arg as new key and split_keyeq (arg) as value.
Note that when replacing old key, the old values are freed.
-
+
@@ -3465,13 +3468,13 @@ Note that when replacing old key, the old values are freed.
a OstreeKernelArgs instance
+ line="437">a OstreeKernelArgs instance
key or key/value pair for replacement
+ line="438">key or key/value pair for replacement
@@ -3481,18 +3484,18 @@ Note that when replacing old key, the old values are freed.
version="2019.3">
Extracts all key value pairs in @kargs and appends to a temporary
+ line="736">Extracts all key value pairs in @kargs and appends to a temporary
GString in forms of "key=value" or "key" if value is NULL separated
by a single whitespace, and returns the temporary string with the
GString wrapper freed
Note: the application will be terminated if one of the values array
in @kargs is NULL
-
+
a string of "key=value" pairs or "key" if value is NULL,
+ line="748">a string of "key=value" pairs or "key" if value is NULL,
separated by single whitespaces
@@ -3500,7 +3503,7 @@ separated by single whitespaces
a OstreeKernelArgs instance
+ line="738">a OstreeKernelArgs instance
@@ -3510,14 +3513,14 @@ separated by single whitespaces
version="2019.3">
Extracts all key value pairs in @kargs and appends to a temporary
+ line="703">Extracts all key value pairs in @kargs and appends to a temporary
array in forms of "key=value" or "key" if value is NULL, and returns
the temporary array with the GPtrArray wrapper freed
-
+
an array of "key=value" pairs or "key" if value is NULL
+ line="711">an array of "key=value" pairs or "key" if value is NULL
@@ -3526,7 +3529,7 @@ the temporary array with the GPtrArray wrapper freed
a OstreeKernelArgs instance
+ line="705">a OstreeKernelArgs instance
@@ -3536,8 +3539,8 @@ the temporary array with the GPtrArray wrapper freed
version="2019.3">
Frees the OstreeKernelArgs structure pointed by *loc
-
+ line="214">Frees the OstreeKernelArgs structure pointed by *loc
+
@@ -3548,7 +3551,7 @@ the temporary array with the GPtrArray wrapper freed
allow-none="1">
Address of an OstreeKernelArgs pointer
+ line="216">Address of an OstreeKernelArgs pointer
@@ -3559,20 +3562,20 @@ the temporary array with the GPtrArray wrapper freed
introspectable="0">
Initializes a new OstreeKernelArgs then parses and appends @options
+ line="681">Initializes a new OstreeKernelArgs then parses and appends @options
to the empty OstreeKernelArgs
-
+
newly allocated #OstreeKernelArgs with @options appended
+ line="688">newly allocated #OstreeKernelArgs with @options appended
a string representing command line arguments
+ line="683">a string representing command line arguments
@@ -3583,12 +3586,12 @@ to the empty OstreeKernelArgs
introspectable="0">
Initializes a new OstreeKernelArgs structure and returns it
-
+ line="174">Initializes a new OstreeKernelArgs structure and returns it
+
A newly created #OstreeKernelArgs for kernel arguments
+ line="179">A newly created #OstreeKernelArgs for kernel arguments
@@ -3596,12 +3599,12 @@ to the empty OstreeKernelArgs
-
+
-
+
@@ -3610,7 +3613,7 @@ to the empty OstreeKernelArgs
-
+
@@ -3619,7 +3622,7 @@ to the empty OstreeKernelArgs
-
+
@@ -3680,7 +3683,7 @@ to the empty OstreeKernelArgs
-
+
@@ -3691,14 +3694,14 @@ to the empty OstreeKernelArgs
-
+
+ line="54"/>
@@ -3707,7 +3710,7 @@ to the empty OstreeKernelArgs
+ line="55"/>
@@ -3716,7 +3719,7 @@ to the empty OstreeKernelArgs
+ line="56"/>
@@ -3725,7 +3728,7 @@ to the empty OstreeKernelArgs
+ line="57"/>
@@ -3734,7 +3737,7 @@ to the empty OstreeKernelArgs
+ line="58"/>
@@ -3744,7 +3747,7 @@ to the empty OstreeKernelArgs
-
+
c:type="OSTREE_MAX_METADATA_SIZE">
Default limit for maximum permitted size in bytes of metadata objects fetched
+ line="30">Default limit for maximum permitted size in bytes of metadata objects fetched
over HTTP (including repo/config files, refs, and commit/dirtree/dirmeta
objects). This is an arbitrary number intended to mitigate disk space
exhaustion attacks.
-
+
c:type="OSTREE_MAX_METADATA_WARN_SIZE">
This variable is no longer meaningful, it is kept only for compatibility.
-
+ line="40">This variable is no longer meaningful, it is kept only for compatibility.
+
version="2021.1">
GVariant type `b`: Set if this commit is intended to be bootable
-
+ line="26">GVariant type `b`: Set if this commit is intended to be bootable
+
version="2021.1">
GVariant type `s`: Contains the Linux kernel release (i.e. `uname -r`)
-
+ line="33">GVariant type `s`: Contains the Linux kernel release (i.e. `uname -r`)
+
version="2018.9">
GVariant type `s`. This key can be used in the repo metadata which is stored
+ line="1661">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
@@ -3831,13 +3834,13 @@ 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.
-
+
-
+
@@ -3846,7 +3849,7 @@ bugs with their P2P implementations.
-
+
@@ -3855,7 +3858,7 @@ bugs with their P2P implementations.
-
+
@@ -3870,14 +3873,14 @@ bugs with their P2P implementations.
glib:type-struct="MutableTreeClass">
Private instance structure.
-
+ line="50">Private instance structure.
+
-
+
A new tree
+ line="648">A new tree
@@ -3886,32 +3889,32 @@ bugs with their P2P implementations.
version="2018.7">
Creates a new OstreeMutableTree with the contents taken from the given repo
+ line="656">Creates a new OstreeMutableTree with the contents taken from the given repo
and checksums. The data will be loaded from the repo lazily as needed.
-
+
A new tree
+ line="665">A new tree
The repo which contains the objects refered by the checksums.
+ line="658">The repo which contains the objects refered by the checksums.
dirtree checksum
+ line="659">dirtree checksum
dirmeta checksum
+ line="660">dirmeta checksum
@@ -3922,26 +3925,26 @@ and checksums. The data will be loaded from the repo lazily as needed.
throws="1">
Creates a new OstreeMutableTree with the contents taken from the given commit.
+ line="682">Creates a new OstreeMutableTree with the contents taken from the given commit.
The data will be loaded from the repo lazily as needed.
-
+
A new tree
+ line="690">A new tree
The repo which contains the objects refered by the checksums.
+ line="684">The repo which contains the objects refered by the checksums.
ref or SHA-256 checksum
+ line="685">ref or SHA-256 checksum
@@ -3952,22 +3955,22 @@ The data will be loaded from the repo lazily as needed.
throws="1">
In some cases, a tree may be in a "lazy" state that loads
+ line="620">In some cases, a tree may be in a "lazy" state that loads
data in the background; if an error occurred during a non-throwing
API call, it will have been cached. This function checks for a
cached error. The tree remains in error state.
-
+
`TRUE` on success
+ line="630">`TRUE` on success
Tree
+ line="622">Tree
@@ -3977,9 +3980,9 @@ cached error. The tree remains in error state.
throws="1">
Returns the subdirectory of self with filename @name, creating an empty one
+ line="361">Returns the subdirectory of self with filename @name, creating an empty one
it if it doesn't exist.
-
+
@@ -3987,13 +3990,13 @@ it if it doesn't exist.
Tree
+ line="363">Tree
Name of subdirectory of self to retrieve/creates
+ line="364">Name of subdirectory of self to retrieve/creates
transfer-ownership="full">
the subdirectory
+ line="365">the subdirectory
@@ -4012,9 +4015,9 @@ it if it doesn't exist.
throws="1">
Create all parent trees necessary for the given @split_path to
+ line="437">Create all parent trees necessary for the given @split_path to
exist.
-
+
@@ -4022,13 +4025,13 @@ exist.
Tree
+ line="439">Tree
File path components
+ line="440">File path components
@@ -4036,7 +4039,7 @@ exist.
SHA256 checksum for metadata
+ line="441">SHA256 checksum for metadata
transfer-ownership="full">
The parent tree
+ line="442">The parent tree
@@ -4055,16 +4058,16 @@ exist.
version="2018.7">
Merges @self with the tree given by @contents_checksum and
+ line="492">Merges @self with the tree given by @contents_checksum and
@metadata_checksum, but only if it's possible without writing new objects to
the @repo. We can do this if either @self is empty, the tree given by
@contents_checksum is empty or if both trees already have the same
@contents_checksum.
-
+
@TRUE if merge was successful, @FALSE if it was not possible.
+ line="501">@TRUE if merge was successful, @FALSE if it was not possible.
This function enables optimisations when composing trees. The provided
checksums are not loaded or checked when this function is called. Instead
@@ -4088,7 +4091,7 @@ the contents will be loaded only when needed.
-
+
@@ -4099,11 +4102,11 @@ the contents will be loaded only when needed.
-
+
All children files (the value is a checksum)
+ line="611">All children files (the value is a checksum)
@@ -4117,7 +4120,7 @@ the contents will be loaded only when needed.
-
+
@@ -4129,11 +4132,11 @@ the contents will be loaded only when needed.
-
+
All children directories
+ line="598">All children directories
@@ -4148,7 +4151,7 @@ the contents will be loaded only when needed.
-
+
@@ -4156,13 +4159,13 @@ the contents will be loaded only when needed.
Tree
+ line="404">Tree
name
+ line="405">name
transfer-ownership="full">
checksum
+ line="406">checksum
transfer-ownership="full">
subdirectory
+ line="407">subdirectory
@@ -4191,8 +4194,8 @@ the contents will be loaded only when needed.
throws="1">
Remove the file or subdirectory named @name from the mutable tree @self.
-
+ line="324">Remove the file or subdirectory named @name from the mutable tree @self.
+
@@ -4200,19 +4203,19 @@ the contents will be loaded only when needed.
Tree
+ line="326">Tree
Name of file or subdirectory to remove
+ line="327">Name of file or subdirectory to remove
If @FALSE, an error will be thrown if @name does not exist in the tree
+ line="328">If @FALSE, an error will be thrown if @name does not exist in the tree
@@ -4220,7 +4223,7 @@ the contents will be loaded only when needed.
-
+
@@ -4238,7 +4241,7 @@ the contents will be loaded only when needed.
-
+
@@ -4253,7 +4256,7 @@ the contents will be loaded only when needed.
-
+
@@ -4269,9 +4272,9 @@ the contents will be loaded only when needed.
Traverse @start number of elements starting from @split_path; the
+ line="557">Traverse @start number of elements starting from @split_path; the
child will be returned in @out_subdir.
-
+
@@ -4279,13 +4282,13 @@ child will be returned in @out_subdir.
Tree
+ line="559">Tree
Split pathname
+ line="560">Split pathname
@@ -4293,7 +4296,7 @@ child will be returned in @out_subdir.
Descend from this number of elements in @split_path
+ line="561">Descend from this number of elements in @split_path
transfer-ownership="full">
Target parent
+ line="562">Target parent
@@ -4311,13 +4314,13 @@ child will be returned in @out_subdir.
-
+
-
+
@@ -4328,12 +4331,12 @@ child will be returned in @out_subdir.
-
+
An #OstreeObjectType
+ line="90">An #OstreeObjectType
@@ -4343,76 +4346,100 @@ child will be returned in @out_subdir.
version="2018.3">
The name of a `GKeyFile` group for data that should not
+ line="28">The name of a `GKeyFile` group for data that should not
be carried across upgrades. For more information,
see ostree_deployment_origin_remove_transient_state().
-
+
Enumeration for core object types; %OSTREE_OBJECT_TYPE_FILE is for
+ line="61">Enumeration for core object types; %OSTREE_OBJECT_TYPE_FILE is for
content, the other types are metadata.
-
+
Content; regular file, symbolic link
+ line="63">Content; regular file, symbolic link
List of children (trees or files), and metadata
+ line="64">List of children (trees or files), and metadata
Directory metadata
+ line="65">Directory metadata
Toplevel object, refers to tree and dirmeta for root
+ line="66">Toplevel object, refers to tree and dirmeta for root
Toplevel object, refers to a deleted commit
+ line="67">Toplevel object, refers to a deleted commit
Detached metadata for a commit
+ line="68">Detached metadata for a commit
Symlink to a .file given its checksum on the payload only.
+ line="69">Symlink to a .file given its checksum on the payload only.
+
+
+ Detached xattrs content, for 'bare-split-xattrs' mode.
+
+
+ Hardlink to a .file-xattrs given the checksum of its .file object.
+
+ Filesystem path that is created on an ostree-booted system.
+
+
+
ostree release version component (e.g. 2 if %OSTREE_VERSION is 2017.2)
-
+ line="37">ostree release version component (e.g. 2 if %OSTREE_VERSION is 2017.2)
+
-
+
@@ -4421,7 +4448,7 @@ content, the other types are metadata.
-
+
@@ -4430,7 +4457,7 @@ content, the other types are metadata.
-
+
@@ -4439,7 +4466,7 @@ content, the other types are metadata.
-
+
@@ -4448,7 +4475,7 @@ content, the other types are metadata.
-
+
@@ -4457,7 +4484,7 @@ content, the other types are metadata.
-
+
@@ -4466,7 +4493,7 @@ content, the other types are metadata.
-
+
@@ -4478,7 +4505,7 @@ content, the other types are metadata.
version="2018.6">
The name of a ref which is used to store metadata for the entire repository,
+ line="1638">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.
@@ -4493,7 +4520,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.
-
+
This represents the configuration for a single remote repository. Currently,
+ line="36">This represents the configuration for a single remote repository. Currently,
remotes can only be passed around as (reference counted) opaque handles. In
future, more API may be added to create and interrogate them.
-
+
Get the human-readable name of the remote. This is what the user configured,
+ line="163">Get the human-readable name of the remote. This is what the user configured,
if the remote was explicitly configured; and will otherwise be a stable,
arbitrary, string.
-
+
remote’s name
+ line="171">remote’s name
an #OstreeRemote
+ line="165">an #OstreeRemote
@@ -4537,19 +4564,19 @@ arbitrary, string.
version="2018.6">
Get the URL from the remote.
-
+ line="183">Get the URL from the remote.
+
the remote's URL
+ line="189">the remote's URL
an #OstreeRemote
+ line="185">an #OstreeRemote
@@ -4557,19 +4584,19 @@ arbitrary, string.
Increase the reference count on the given @remote.
-
+ line="113">Increase the reference count on the given @remote.
+
a copy of @remote, for convenience
+ line="119">a copy of @remote, for convenience
an #OstreeRemote
+ line="115">an #OstreeRemote
@@ -4577,9 +4604,9 @@ arbitrary, string.
Decrease the reference count on the given @remote and free it if the
+ line="132">Decrease the reference count on the given @remote and free it if the
reference count reaches 0.
-
+
@@ -4587,7 +4614,7 @@ reference count reaches 0.
an #OstreeRemote
+ line="134">an #OstreeRemote
@@ -4600,18 +4627,18 @@ reference count reaches 0.
glib:type-name="OstreeRepo"
glib:get-type="ostree_repo_get_type">
-
+
An accessor object for an OSTree repository located at @path
+ line="1406">An accessor object for an OSTree repository located at @path
Path to a repository
+ line="1404">Path to a repository
@@ -4619,16 +4646,16 @@ reference count reaches 0.
If the current working directory appears to be an OSTree
+ line="1479">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
/ostree/repo.
-
+
An accessor object for an OSTree repository located at /ostree/repo
+ line="1488">An accessor object for an OSTree repository located at /ostree/repo
@@ -4636,26 +4663,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="1462">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="1470">An accessor object for the OSTree repository located at @repo_path.
Path to a repository
+ line="1464">Path to a repository
Path to the system root
+ line="1465">Path to the system root
@@ -4666,7 +4693,7 @@ instead of assuming "/".
throws="1">
This is a file-descriptor relative version of ostree_repo_create().
+ line="2896">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.
@@ -4678,30 +4705,30 @@ the mode or configuration (`repo/config`) of an existing repo.
The @options dict may contain:
- collection-id: s: Set as collection ID in repo/config (Since 2017.9)
-
+
A new OSTree repository reference
+ line="2918">A new OSTree repository reference
Directory fd
+ line="2898">Directory fd
Path
+ line="2899">Path
The mode to store the repository in
+ line="2900">The mode to store the repository in
a{sv}: See below for accepted keys
+ line="2901">a{sv}: See below for accepted keys
Cancellable
+ line="2902">Cancellable
@@ -4727,7 +4754,7 @@ The @options dict may contain:
-
+
@@ -4735,7 +4762,7 @@ The @options dict may contain:
a repo mode as a string
+ line="2720">a repo mode as a string
the corresponding #OstreeRepoMode
+ line="2721">the corresponding #OstreeRepoMode
@@ -4755,27 +4782,27 @@ The @options dict may contain:
throws="1">
This combines ostree_repo_new() (but using fd-relative access) with
+ line="1427">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="1436">An accessor object for an OSTree repository located at @dfd + @path
Directory fd
+ line="1429">Directory fd
Path
+ line="1430">Path
Convenient "changed" callback for use with
+ line="5121">Convenient "changed" callback for use with
ostree_async_progress_new_and_connect() when pulling from a remote
repository.
@@ -4802,7 +4829,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.
-
+
@@ -4810,7 +4837,7 @@ and @user_data is ignored.
Async progress
+ line="5123">Async progress
allow-none="1">
User data
+ line="5124">User data
@@ -4829,14 +4856,14 @@ and @user_data is ignored.
version="2018.5">
This hash table is a mapping from #GVariant which can be accessed
+ line="295">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.
-
+
A new hash table
+ line="302">A new hash table
@@ -4847,13 +4874,13 @@ a similar #GVariant or and array of them, listing the parents of the key.
c:identifier="ostree_repo_traverse_new_reachable">
This hash table is a set of #GVariant which can be accessed via
+ line="280">This hash table is a set of #GVariant which can be accessed via
ostree_object_name_deserialize().
-
+
A new hash table
+ line="286">A new hash table
@@ -4865,13 +4892,13 @@ ostree_object_name_deserialize().
version="2018.5">
Gets all the commits that a certain object belongs to, as recorded
+ line="346">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.
-
+
An array of checksums for
+ line="352">An array of checksums for
the commits the key belongs to.
@@ -4894,11 +4921,11 @@ the commits the key belongs to.
throws="1">
Abort the active transaction; any staged objects and ref changes will be
+ line="2381">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.
-
+
@@ -4906,7 +4933,7 @@ transaction will do nothing and return successfully.
An #OstreeRepo
+ line="2383">An #OstreeRepo
allow-none="1">
Cancellable
+ line="2384">Cancellable
@@ -4925,8 +4952,8 @@ transaction will do nothing and return successfully.
throws="1">
Add a GPG signature to a summary file.
-
+ line="5492">Add a GPG signature to a summary file.
+
@@ -4934,13 +4961,13 @@ transaction will do nothing and return successfully.
Self
+ line="5494">Self
NULL-terminated array of GPG keys.
+ line="5495">NULL-terminated array of GPG keys.
@@ -4951,7 +4978,7 @@ transaction will do nothing and return successfully.
allow-none="1">
GPG home directory, or %NULL
+ line="5496">GPG home directory, or %NULL
allow-none="1">
A #GCancellable
+ line="5497">A #GCancellable
@@ -4970,8 +4997,8 @@ transaction will do nothing and return successfully.
throws="1">
Append a GPG signature to a commit.
-
+ line="5271">Append a GPG signature to a commit.
+
@@ -4979,19 +5006,19 @@ transaction will do nothing and return successfully.
Self
+ line="5273">Self
SHA256 of given commit to sign
+ line="5274">SHA256 of given commit to sign
Signature data
+ line="5275">Signature data
allow-none="1">
A #GCancellable
+ line="5276">A #GCancellable
@@ -5011,7 +5038,7 @@ transaction will do nothing and return successfully.
throws="1">
Similar to ostree_repo_checkout_tree(), but uses directory-relative
+ line="1327">Similar to ostree_repo_checkout_tree(), but uses directory-relative
paths for the destination, uses a new `OstreeRepoCheckoutAtOptions`,
and takes a commit checksum and optional subpath pair, rather than
requiring use of `GFile` APIs for the caller.
@@ -5022,7 +5049,7 @@ use with GObject introspection.
Note in addition that unlike ostree_repo_checkout_tree(), the
default is not to use the repository-internal uncompressed objects
cache.
-
+
@@ -5030,7 +5057,7 @@ cache.
Repo
+ line="1329">Repo
allow-none="1">
Options
+ line="1330">Options
Directory FD for destination
+ line="1331">Directory FD for destination
Directory for destination
+ line="1332">Directory for destination
Checksum for commit
+ line="1333">Checksum for commit
allow-none="1">
Cancellable
+ line="1334">Cancellable
@@ -5077,10 +5104,10 @@ cache.
throws="1">
Call this after finishing a succession of checkout operations; it
+ line="1466">Call this after finishing a succession of checkout operations; it
will delete any currently-unused uncompressed objects from the
cache.
-
+
@@ -5088,7 +5115,7 @@ cache.
Repo
+ line="1468">Repo
allow-none="1">
Cancellable
+ line="1469">Cancellable
@@ -5107,11 +5134,11 @@ cache.
throws="1">
Check out @source into @destination, which must live on the
+ line="1245">Check out @source into @destination, which must live on the
physical filesystem. @source may be any subdirectory of a given
commit. The @mode and @overwrite_mode allow control over how the
files are checked out.
-
+
@@ -5119,38 +5146,38 @@ files are checked out.
Repo
+ line="1247">Repo
Options controlling all files
+ line="1248">Options controlling all files
Whether or not to overwrite files
+ line="1249">Whether or not to overwrite files
Place tree here
+ line="1250">Place tree here
Source tree
+ line="1251">Source tree
Source info
+ line="1252">Source info
allow-none="1">
Cancellable
+ line="1253">Cancellable
@@ -5170,7 +5197,7 @@ files are checked out.
throws="1">
Similar to ostree_repo_checkout_tree(), but uses directory-relative
+ line="1284">Similar to ostree_repo_checkout_tree(), but uses directory-relative
paths for the destination, uses a new `OstreeRepoCheckoutAtOptions`,
and takes a commit checksum and optional subpath pair, rather than
requiring use of `GFile` APIs for the caller.
@@ -5180,7 +5207,7 @@ default is not to use the repository-internal uncompressed objects
cache.
This function is deprecated. Use ostree_repo_checkout_at() instead.
-
+
@@ -5188,7 +5215,7 @@ This function is deprecated. Use ostree_repo_checkout_at() instead.
Repo
+ line="1286">Repo
allow-none="1">
Options
+ line="1287">Options
Directory FD for destination
+ line="1288">Directory FD for destination
Directory for destination
+ line="1289">Directory for destination
Checksum for commit
+ line="1290">Checksum for commit
allow-none="1">
Cancellable
+ line="1291">Cancellable
@@ -5235,7 +5262,7 @@ This function is deprecated. Use ostree_repo_checkout_at() instead.
throws="1">
Complete the transaction. Any refs set with
+ line="2281">Complete the transaction. Any refs set with
ostree_repo_transaction_set_ref() or
ostree_repo_transaction_set_refspec() will be written out.
@@ -5245,7 +5272,7 @@ have terminated before this function is invoked.
Locking: Releases `shared` lock acquired by `ostree_repo_prepare_transaction()`
Multithreading: This function is *not* MT safe; only one transaction can be
active at a time.
-
+
@@ -5253,7 +5280,7 @@ active at a time.
An #OstreeRepo
+ line="2283">An #OstreeRepo
allow-none="1">
A set of statistics of things
+ line="2284">A set of statistics of things
that happened during this transaction.
@@ -5275,17 +5302,17 @@ that happened during this transaction.
allow-none="1">
Cancellable
+ line="2286">Cancellable
-
+
A newly-allocated copy of the repository config
+ line="1610">A newly-allocated copy of the repository config
@@ -5297,7 +5324,7 @@ that happened during this transaction.
Create the underlying structure on disk for the repository, and call
+ line="2848">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
@@ -5311,7 +5338,7 @@ Since 2017.9, "existing repository" is defined by the existence of an
This function predates ostree_repo_create_at(). It is an error to call
this function on a repository initialized via ostree_repo_open_at().
-
+
@@ -5319,13 +5346,13 @@ this function on a repository initialized via ostree_repo_open_at().
An #OstreeRepo
+ line="2850">An #OstreeRepo
The mode to store the repository in
+ line="2851">The mode to store the repository in
allow-none="1">
Cancellable
+ line="2852">Cancellable
@@ -5344,10 +5371,10 @@ this function on a repository initialized via ostree_repo_open_at().
throws="1">
Remove the object of type @objtype with checksum @sha256
+ line="4565">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.
-
+
@@ -5355,19 +5382,19 @@ is thrown if the object does not exist.
Repo
+ line="4567">Repo
Object type
+ line="4568">Object type
Checksum
+ line="4569">Checksum
allow-none="1">
Cancellable
+ line="4570">Cancellable
@@ -5384,27 +5411,27 @@ is thrown if the object does not exist.
Check whether two opened repositories are the same on disk: if their root
+ line="3796">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="3805">%TRUE if @a and @b are the same repository on disk, %FALSE otherwise
an #OstreeRepo
+ line="3798">an #OstreeRepo
an #OstreeRepo
+ line="3799">an #OstreeRepo
@@ -5415,9 +5442,9 @@ 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="1257">Import an archive file @archive into the repository, and write its
file structure to @mtree.
-
+
@@ -5425,20 +5452,20 @@ file structure to @mtree.
An #OstreeRepo
+ line="1259">An #OstreeRepo
Options controlling conversion
+ line="1260">Options controlling conversion
An #OstreeRepoFile for the base directory
+ line="1261">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="1262">A `struct archive`, but specified as void to avoid a dependency on the libarchive headers
allow-none="1">
Cancellable
+ line="1263">Cancellable
@@ -5466,7 +5493,7 @@ file structure to @mtree.
version="2018.6">
Find reachable remote URIs which claim to provide any of the given named
+ line="5427">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
@@ -5506,7 +5533,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.
-
+
@@ -5514,13 +5541,13 @@ This will use the thread-default #GMainContext, but will not iterate it.
an #OstreeRepo
+ line="5429">an #OstreeRepo
non-empty array of collection–ref pairs to find remotes for
+ line="5430">non-empty array of collection–ref pairs to find remotes for
@@ -5531,13 +5558,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="5431">a GVariant `a{sv}` with an extensible set of flags
non-empty array of
+ line="5432">non-empty array of
#OstreeRepoFinder instances to use, or %NULL to use the system defaults
@@ -5549,7 +5576,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="5434">an #OstreeAsyncProgress to update with the operation’s
progress, or %NULL
@@ -5559,7 +5586,7 @@ This will use the thread-default #GMainContext, but will not iterate it.
allow-none="1">
a #GCancellable, or %NULL
+ line="5436">a #GCancellable, or %NULL
closure="6">
asynchronous completion callback
+ line="5437">asynchronous completion callback
allow-none="1">
data to pass to @callback
+ line="5438">data to pass to @callback
@@ -5590,13 +5617,13 @@ This will use the thread-default #GMainContext, but will not iterate it.
throws="1">
Finish an asynchronous pull operation started with
+ line="6226">Finish an asynchronous pull operation started with
ostree_repo_find_remotes_async().
-
+
a potentially empty array
+ line="6235">a potentially empty array
of #OstreeRepoFinderResults, followed by a %NULL terminator element; or
%NULL on error
@@ -5607,13 +5634,13 @@ ostree_repo_find_remotes_async().
an #OstreeRepo
+ line="6228">an #OstreeRepo
the asynchronous result
+ line="6229">the asynchronous result
@@ -5624,10 +5651,10 @@ ostree_repo_find_remotes_async().
throws="1">
Verify consistency of the object; this performs checks only relevant to the
+ line="4681">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.
-
+
@@ -5635,19 +5662,19 @@ traverse metadata objects for example.
Repo
+ line="4683">Repo
Object type
+ line="4684">Object type
Checksum
+ line="4685">Checksum
allow-none="1">
Cancellable
+ line="4686">Cancellable
@@ -5666,20 +5693,20 @@ traverse metadata objects for example.
version="2019.2">
Get the bootloader configured. See the documentation for the
+ line="6674">Get the bootloader configured. See the documentation for the
"sysroot.bootloader" config key.
-
+
bootloader configuration for the sysroot
+ line="6681">bootloader configuration for the sysroot
an #OstreeRepo
+ line="6676">an #OstreeRepo
@@ -5689,29 +5716,29 @@ traverse metadata objects for example.
version="2018.6">
Get the collection ID of this repository. See [collection IDs][collection-ids].
-
+ line="6602">Get the collection ID of this repository. See [collection IDs][collection-ids].
+
collection ID for the repository
+ line="6608">collection ID for the repository
an #OstreeRepo
+ line="6604">an #OstreeRepo
-
+
The repository configuration; do not modify
+ line="1595">The repository configuration; do not modify
@@ -5725,13 +5752,13 @@ traverse metadata objects for example.
version="2018.9">
Get the set of default repo finders configured. See the documentation for
+ line="6655">Get the set of default repo finders configured. See the documentation for
the "core.default-repo-finders" config key.
-
+
+ line="6662">
%NULL-terminated array of strings.
@@ -5741,7 +5768,7 @@ the "core.default-repo-finders" config key.
an #OstreeRepo
+ line="6657">an #OstreeRepo
@@ -5751,22 +5778,22 @@ the "core.default-repo-finders" config key.
version="2016.4">
In some cases it's useful for applications to access the repository
+ line="3747">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).
-
+
File descriptor for repository root - owned by @self
+ line="3756">File descriptor for repository root - owned by @self
Repo
+ line="3749">Repo
@@ -5775,19 +5802,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="3694">For more information see ostree_repo_set_disable_fsync().
+
Whether or not fsync() is enabled for this repo.
+ line="3700">Whether or not fsync() is enabled for this repo.
An #OstreeRepo
+ line="3696">An #OstreeRepo
@@ -5798,22 +5825,22 @@ repository (to see whether a ref was written).
throws="1">
Determine the number of bytes of free disk space that are reserved according
+ line="3830">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.
-
+
%TRUE on success, %FALSE otherwise.
+ line="3841">%TRUE on success, %FALSE otherwise.
Repo
+ line="3832">Repo
transfer-ownership="full">
Location to store the result
+ line="3833">Location to store the result
-
+
@@ -5841,20 +5868,20 @@ core.min-free-space-percent repo config options.
Before this function can be used, ostree_repo_init() must have been
+ line="3857">Before this function can be used, ostree_repo_init() must have been
called.
-
+
Parent repository, or %NULL if none
+ line="3864">Parent repository, or %NULL if none
Repo
+ line="3859">Repo
@@ -5862,21 +5889,21 @@ called.
Note that since the introduction of ostree_repo_open_at(), this function may
+ line="3725">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="3733">Path to repo
Repo
+ line="3727">Repo
@@ -5887,41 +5914,41 @@ that API. In general, you should avoid use of this API.
throws="1">
OSTree remotes are represented by keyfile groups, formatted like:
+ line="1102">OSTree remotes are represented by keyfile groups, formatted like:
`[remote "remotename"]`. This function returns a value named @option_name
underneath that group, and returns it as a boolean.
If the option is not set, @out_value will be set to @default_value. If an
error is returned, @out_value will be set to %FALSE.
-
+
%TRUE on success, otherwise %FALSE with @error set
+ line="1117">%TRUE on success, otherwise %FALSE with @error set
A OstreeRepo
+ line="1104">A OstreeRepo
Name
+ line="1105">Name
Option
+ line="1106">Option
Value returned if @option_name is not present
+ line="1107">Value returned if @option_name is not present
transfer-ownership="full">
location to store the result.
+ line="1108">location to store the result.
@@ -5941,35 +5968,35 @@ error is returned, @out_value will be set to %FALSE.
throws="1">
OSTree remotes are represented by keyfile groups, formatted like:
+ line="1024">OSTree remotes are represented by keyfile groups, formatted like:
`[remote "remotename"]`. This function returns a value named @option_name
underneath that group, and returns it as a zero terminated array of strings.
If the option is not set, or if an error is returned, @out_value will be set
to %NULL.
-
+
%TRUE on success, otherwise %FALSE with @error set
+ line="1040">%TRUE on success, otherwise %FALSE with @error set
A OstreeRepo
+ line="1026">A OstreeRepo
Name
+ line="1027">Name
Option
+ line="1028">Option
transfer-ownership="full">
location to store the list
+ line="1029">location to store the list
of strings. The list should be freed with
g_strfreev().
@@ -5993,34 +6020,34 @@ to %NULL.
throws="1">
OSTree remotes are represented by keyfile groups, formatted like:
+ line="946">OSTree remotes are represented by keyfile groups, formatted like:
`[remote "remotename"]`. This function returns a value named @option_name
underneath that group, or @default_value if the remote exists but not the
option name. If an error is returned, @out_value will be set to %NULL.
-
+
%TRUE on success, otherwise %FALSE with @error set
+ line="960">%TRUE on success, otherwise %FALSE with @error set
A OstreeRepo
+ line="948">A OstreeRepo
Name
+ line="949">Name
Option
+ line="950">Option
allow-none="1">
Value returned if @option_name is not present
+ line="951">Value returned if @option_name is not present
transfer-ownership="full">
Return location for value
+ line="952">Return location for value
@@ -6049,16 +6076,16 @@ option name. If an error is returned, @out_value will be set to %NULL.
throws="1">
Sign the given @data with the specified keys in @key_id. Similar to
+ line="5558">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,
+ line="5575">@TRUE if @data has been signed successfully,
@FALSE in case of error (@error will contain the reason).
@@ -6066,25 +6093,25 @@ You can use ostree_repo_gpg_verify_data() to verify the signatures.
Self
+ line="5560">Self
Data as a #GBytes
+ line="5561">Data as a #GBytes
Existing signatures to append to (or %NULL)
+ line="5562">Existing signatures to append to (or %NULL)
NULL-terminated array of GPG keys.
+ line="5563">NULL-terminated array of GPG keys.
@@ -6095,7 +6122,7 @@ You can use ostree_repo_gpg_verify_data() to verify the signatures.
allow-none="1">
GPG home directory, or %NULL
+ line="5564">GPG home directory, or %NULL
transfer-ownership="full">
in case of success will contain signature
+ line="5565">in case of success will contain signature
allow-none="1">
A #GCancellable
+ line="5566">A #GCancellable
@@ -6124,23 +6151,23 @@ You can use ostree_repo_gpg_verify_data() to verify the signatures.
throws="1">
Verify @signatures for @data using GPG keys in the keyring for
+ line="5989">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="6006">an #OstreeGpgVerifyResult, or %NULL on error
Repository
+ line="5991">Repository
allow-none="1">
Name of remote
+ line="5992">Name of remote
Data as a #GBytes
+ line="5993">Data as a #GBytes
Signatures as a #GBytes
+ line="5994">Signatures as a #GBytes
allow-none="1">
Path to directory GPG keyrings; overrides built-in default if given
+ line="5995">Path to directory GPG keyrings; overrides built-in default if given
allow-none="1">
Path to additional keyring file (not a directory)
+ line="5996">Path to additional keyring file (not a directory)
allow-none="1">
Cancellable
+ line="5997">Cancellable
@@ -6198,32 +6225,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="4523">Set @out_have_object to %TRUE if @self contains the given object;
%FALSE otherwise.
-
+
%FALSE if an unexpected error occurred, %TRUE otherwise
+ line="4535">%FALSE if an unexpected error occurred, %TRUE otherwise
Repo
+ line="4525">Repo
Object type
+ line="4526">Object type
ASCII SHA256 checksum
+ line="4527">ASCII SHA256 checksum
transfer-ownership="full">
%TRUE if repository contains object
+ line="4528">%TRUE if repository contains object
allow-none="1">
Cancellable
+ line="4529">Cancellable
@@ -6249,24 +6276,24 @@ 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="3766">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.
This function does no I/O.
-
+
hash value for the #OstreeRepo
+ line="3777">hash value for the #OstreeRepo
an #OstreeRepo
+ line="3768">an #OstreeRepo
@@ -6277,9 +6304,9 @@ This function does no I/O.
throws="1">
Import an archive file @archive into the repository, and write its
+ line="843">Import an archive file @archive into the repository, and write its
file structure to @mtree.
-
+
@@ -6287,13 +6314,13 @@ file structure to @mtree.
An #OstreeRepo
+ line="845">An #OstreeRepo
Options structure, ensure this is zeroed, then set specific variables
+ line="846">Options structure, ensure this is zeroed, then set specific variables
@@ -6303,13 +6330,13 @@ file structure to @mtree.
allow-none="1">
Really this is "struct archive*"
+ line="847">Really this is "struct archive*"
The #OstreeMutableTree to write to
+ line="848">The #OstreeMutableTree to write to
allow-none="1">
Optional commit modifier
+ line="849">Optional commit modifier
@@ -6328,7 +6355,7 @@ file structure to @mtree.
allow-none="1">
Cancellable
+ line="850">Cancellable
@@ -6338,13 +6365,13 @@ file structure to @mtree.
throws="1">
Copy object named by @objtype and @checksum into @self from the
+ line="4708">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.
Otherwise, a copy will be performed.
-
+
@@ -6352,25 +6379,25 @@ Otherwise, a copy will be performed.
Destination repo
+ line="4710">Destination repo
Source repo
+ line="4711">Source repo
Object type
+ line="4712">Object type
checksum
+ line="4713">checksum
allow-none="1">
Cancellable
+ line="4714">Cancellable
@@ -6390,13 +6417,13 @@ Otherwise, a copy will be performed.
throws="1">
Copy object named by @objtype and @checksum into @self from the
+ line="4737">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.
Otherwise, a copy will be performed.
-
+
@@ -6404,31 +6431,31 @@ Otherwise, a copy will be performed.
Destination repo
+ line="4739">Destination repo
Source repo
+ line="4740">Source repo
Object type
+ line="4741">Object type
checksum
+ line="4742">checksum
If %TRUE, assume the source repo is valid and trusted
+ line="4743">If %TRUE, assume the source repo is valid and trusted
allow-none="1">
Cancellable
+ line="4744">Cancellable
-
+
%TRUE if this repository is the root-owned system global repository
+ line="1517">%TRUE if this repository is the root-owned system global repository
Repository
+ line="1515">Repository
@@ -6464,20 +6491,20 @@ Otherwise, a copy will be performed.
throws="1">
Returns whether the repository is writable by the current user.
+ line="1547">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="1555">%TRUE if this repository is writable
Repo
+ line="1549">Repo
@@ -6488,7 +6515,7 @@ If the repository is not writable, the @error indicates why.
throws="1">
List all local, mirrored, and remote refs, mapping them to the commit
+ line="1250">List all local, mirrored, and remote refs, mapping them to the commit
checksums they currently point to in @out_all_refs. If @match_collection_id
is specified, the results will be limited to those with an equal collection
ID.
@@ -6502,18 +6529,18 @@ 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`.
-
+
%TRUE on success, %FALSE otherwise
+ line="1275">%TRUE on success, %FALSE otherwise
Repo
+ line="1252">Repo
If non-%NULL, only list refs from this collection
+ line="1253">If non-%NULL, only list refs from this collection
+ line="1254">
Mapping from collection–ref to checksum
@@ -6541,7 +6568,7 @@ If you want to exclude refs from `refs/remotes`, use
Options controlling listing behavior
+ line="1256">Options controlling listing behavior
@@ -6551,7 +6578,7 @@ If you want to exclude refs from `refs/remotes`, use
allow-none="1">
Cancellable
+ line="1257">Cancellable
@@ -6561,26 +6588,26 @@ If you want to exclude refs from `refs/remotes`, use
throws="1">
This function synchronously enumerates all commit objects starting
+ line="4931">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="4943">%TRUE on success, %FALSE on error, and @error will be set
Repo
+ line="4933">Repo
List commits starting with this checksum
+ line="4934">List commits starting with this checksum
transfer-ownership="container">
+ line="4935">
Map of serialized commit name to variant data
@@ -6602,7 +6629,7 @@ Map of serialized commit name to variant data
allow-none="1">
Cancellable
+ line="4937">Cancellable
@@ -6612,28 +6639,28 @@ Map of serialized commit name to variant data
throws="1">
This function synchronously enumerates all objects in the
+ line="4877">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.
-
+
%TRUE on success, %FALSE on error, and @error will be set
+ line="4891">%TRUE on success, %FALSE on error, and @error will be set
Repo
+ line="4879">Repo
Flags controlling enumeration
+ line="4880">Flags controlling enumeration
@@ -6643,7 +6670,7 @@ to #GVariant values of type %OSTREE_REPO_LIST_OBJECTS_VARIANT_TYPE.
transfer-ownership="container">
+ line="4881">
Map of serialized object name to variant data
@@ -6656,7 +6683,7 @@ Map of serialized object name to variant data
allow-none="1">
Cancellable
+ line="4883">Cancellable
@@ -6664,14 +6691,14 @@ Map of serialized object name to variant data
If @refspec_prefix is %NULL, list all local and remote refspecs,
+ line="811">If @refspec_prefix is %NULL, list all local and remote refspecs,
with their current values in @out_all_refs. Otherwise, only list
refspecs which have @refspec_prefix as a prefix.
@out_all_refs will be returned as a mapping from refspecs (including the
remote name) to checksums. If @refspec_prefix is non-%NULL, it will be
removed as a prefix from the hash table keys.
-
+
@@ -6679,7 +6706,7 @@ removed as a prefix from the hash table keys.
Repo
+ line="813">Repo
allow-none="1">
Only list refs which match this prefix
+ line="814">Only list refs which match this prefix
transfer-ownership="container">
+ line="815">
Mapping from refspec to checksum
@@ -6710,7 +6737,7 @@ removed as a prefix from the hash table keys.
allow-none="1">
Cancellable
+ line="817">Cancellable
@@ -6721,14 +6748,14 @@ removed as a prefix from the hash table keys.
throws="1">
If @refspec_prefix is %NULL, list all local and remote refspecs,
+ line="841">If @refspec_prefix is %NULL, list all local and remote refspecs,
with their current values in @out_all_refs. Otherwise, only list
refspecs which have @refspec_prefix as a prefix.
@out_all_refs will be returned as a mapping from refspecs (including the
remote name) to checksums. Differently from ostree_repo_list_refs(), the
@refspec_prefix will not be removed from the refspecs in the hash table.
-
+
@@ -6736,7 +6763,7 @@ remote name) to checksums. Differently from ostree_repo_list_refs(), the
Repo
+ line="843">Repo
Only list refs which match this prefix
+ line="844">Only list refs which match this prefix
+ line="845">
Mapping from refspec to checksum
@@ -6764,7 +6791,7 @@ remote name) to checksums. Differently from ostree_repo_list_refs(), the
Options controlling listing behavior
+ line="847">Options controlling listing behavior
@@ -6774,7 +6801,7 @@ remote name) to checksums. Differently from ostree_repo_list_refs(), the
allow-none="1">
Cancellable
+ line="848">Cancellable
@@ -6785,9 +6812,9 @@ remote name) to checksums. Differently from ostree_repo_list_refs(), the
throws="1">
This function synchronously enumerates all static delta indexes in the
+ line="169">This function synchronously enumerates all static delta indexes in the
repository, returning its result in @out_indexes.
-
+
@@ -6795,7 +6822,7 @@ repository, returning its result in @out_indexes.
Repo
+ line="171">Repo
transfer-ownership="container">
String name of delta indexes (checksum)
+ line="172">String name of delta indexes (checksum)
@@ -6815,7 +6842,7 @@ repository, returning its result in @out_indexes.
allow-none="1">
Cancellable
+ line="173">Cancellable
@@ -6825,9 +6852,9 @@ repository, returning its result in @out_indexes.
throws="1">
This function synchronously enumerates all static deltas in the
+ line="78">This function synchronously enumerates all static deltas in the
repository, returning its result in @out_deltas.
-
+
@@ -6835,7 +6862,7 @@ repository, returning its result in @out_deltas.
Repo
+ line="80">Repo
transfer-ownership="container">
String name of deltas (checksum-checksum.delta)
+ line="81">String name of deltas (checksum-checksum.delta)
@@ -6855,7 +6882,7 @@ repository, returning its result in @out_deltas.
allow-none="1">
Cancellable
+ line="82">Cancellable
@@ -6865,11 +6892,11 @@ repository, returning its result in @out_deltas.
throws="1">
A version of ostree_repo_load_variant() specialized to commits,
+ line="4853">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.
-
+
@@ -6877,13 +6904,13 @@ means that only a sub-path of the commit is available.
Repo
+ line="4855">Repo
Commit checksum
+ line="4856">Commit checksum
allow-none="1">
Commit
+ line="4857">Commit
allow-none="1">
Commit state
+ line="4858">Commit state
@@ -6913,9 +6940,9 @@ means that only a sub-path of the commit is available.
Load content object, decomposing it into three parts: the actual
+ line="4362">Load content object, decomposing it into three parts: the actual
content (for regular files), the metadata, and extended attributes.
-
+
@@ -6923,13 +6950,13 @@ content (for regular files), the metadata, and extended attributes.
Repo
+ line="4364">Repo
ASCII SHA256 checksum
+ line="4365">ASCII SHA256 checksum
allow-none="1">
File content
+ line="4366">File content
allow-none="1">
File information
+ line="4367">File information
allow-none="1">
Extended attributes
+ line="4368">Extended attributes
allow-none="1">
Cancellable
+ line="4369">Cancellable
@@ -6984,9 +7011,9 @@ content (for regular files), the metadata, and extended attributes.
throws="1">
Load object as a stream; useful when copying objects between
+ line="4423">Load object as a stream; useful when copying objects between
repositories.
-
+
@@ -6994,19 +7021,19 @@ repositories.
Repo
+ line="4425">Repo
Object type
+ line="4426">Object type
ASCII SHA256 checksum
+ line="4427">ASCII SHA256 checksum
transfer-ownership="full">
Stream for object
+ line="4428">Stream for object
transfer-ownership="full">
Length of @out_input
+ line="4429">Length of @out_input
allow-none="1">
Cancellable
+ line="4430">Cancellable
@@ -7043,9 +7070,9 @@ repositories.
throws="1">
Load the metadata object @sha256 of type @objtype, storing the
+ line="4831">Load the metadata object @sha256 of type @objtype, storing the
result in @out_variant.
-
+
@@ -7053,19 +7080,19 @@ result in @out_variant.
Repo
+ line="4833">Repo
Expected object type
+ line="4834">Expected object type
Checksum string
+ line="4835">Checksum string
transfer-ownership="full">
Metadata object
+ line="4836">Metadata object
@@ -7084,11 +7111,11 @@ result in @out_variant.
throws="1">
Attempt to load the metadata object @sha256 of type @objtype if it
+ line="4807">Attempt to load the metadata object @sha256 of type @objtype if it
exists, storing the result in @out_variant. If it doesn't exist,
@out_variant will be set to %NULL and the function will still
return TRUE.
-
+
@@ -7096,19 +7123,19 @@ return TRUE.
Repo
+ line="4809">Repo
Object type
+ line="4810">Object type
ASCII checksum
+ line="4811">ASCII checksum
nullable="1">
Metadata
+ line="4812">Metadata
@@ -7129,7 +7156,7 @@ return TRUE.
throws="1">
Release a lock of type @lock_type from the lock state. If the lock state
+ line="549">Release a lock of type @lock_type from the lock state. If the lock state
becomes empty, the repository is unlocked. Otherwise, the lock state only
changes when transitioning from an exclusive lock back to a shared lock. The
requested @lock_type must be the same type that was requested in the call to
@@ -7145,24 +7172,24 @@ timeout, a %G_IO_ERROR_WOULD_BLOCK error is returned.
If @self is not writable by the user, then no unlocking is attempted and
%TRUE is returned.
-
+
%TRUE on success, otherwise %FALSE with @error set
+ line="573">%TRUE on success, otherwise %FALSE with @error set
a #OstreeRepo
+ line="551">a #OstreeRepo
the type of lock to release
+ line="552">the type of lock to release
a #GCancellable
+ line="553">a #GCancellable
@@ -7182,7 +7209,7 @@ If @self is not writable by the user, then no unlocking is attempted and
throws="1">
Takes a lock on the repository and adds it to the lock state. If @lock_type
+ line="454">Takes a lock on the repository and adds it to the lock state. If @lock_type
is %OSTREE_REPO_LOCK_SHARED, a shared lock is taken. If @lock_type is
%OSTREE_REPO_LOCK_EXCLUSIVE, an exclusive lock is taken. The actual lock
state is only changed when locking a previously unlocked repository or
@@ -7199,24 +7226,24 @@ timeout, a %G_IO_ERROR_WOULD_BLOCK error is returned.
If @self is not writable by the user, then no locking is attempted and
%TRUE is returned.
-
+
%TRUE on success, otherwise %FALSE with @error set
+ line="479">%TRUE on success, otherwise %FALSE with @error set
a #OstreeRepo
+ line="456">a #OstreeRepo
the type of lock to acquire
+ line="457">the type of lock to acquire
a #GCancellable
+ line="458">a #GCancellable
@@ -7236,14 +7263,14 @@ If @self is not writable by the user, then no locking is attempted and
throws="1">
Commits in the "partial" state do not have all their child objects
+ line="2045">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.
This function is used by ostree_repo_pull_with_options(); you
should use this if you are implementing a different type of transport.
-
+
@@ -7251,19 +7278,19 @@ should use this if you are implementing a different type of transport.
Repo
+ line="2047">Repo
Commit SHA-256
+ line="2048">Commit SHA-256
Whether or not this commit is partial
+ line="2049">Whether or not this commit is partial
@@ -7274,14 +7301,14 @@ 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="1994">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
fsck operations to exit properly with an error code if the
repository has been truncated as a result of fsck trying to repair
it.
-
+
@@ -7289,31 +7316,31 @@ it.
Repo
+ line="1996">Repo
Commit SHA-256
+ line="1997">Commit SHA-256
Whether or not this commit is partial
+ line="1998">Whether or not this commit is partial
Reason bitmask for partial commit
+ line="1999">Reason bitmask for partial commit
-
+
@@ -7334,7 +7361,7 @@ it.
throws="1">
Starts or resumes a transaction. In order to write to a repo, you
+ line="1649">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().
@@ -7351,7 +7378,7 @@ transaction.
Locking: Acquires a `shared` lock; release via commit or abort
Multithreading: This function is *not* MT safe; only one transaction can be
active at a time.
-
+
@@ -7359,7 +7386,7 @@ active at a time.
An #OstreeRepo
+ line="1651">An #OstreeRepo
allow-none="1">
Whether this transaction
+ line="1652">Whether this transaction
is resuming from a previous one. This is a legacy state, now OSTree
pulls use per-commit `state/.commitpartial` files.
@@ -7381,7 +7408,7 @@ pulls use per-commit `state/.commitpartial` files.
allow-none="1">
Cancellable
+ line="1655">Cancellable
@@ -7389,7 +7416,7 @@ pulls use per-commit `state/.commitpartial` files.
Delete content from the repository. By default, this function will
+ line="382">Delete content from the repository. By default, this function will
only delete "orphaned" objects not referred to by any commit. This
can happen during a local commit operation, when we have written
content objects but not saved the commit referencing them.
@@ -7404,7 +7431,7 @@ statistics on objects that would be deleted, without actually
deleting them.
Locking: exclusive
-
+
@@ -7412,19 +7439,19 @@ Locking: exclusive
Repo
+ line="384">Repo
Options controlling prune process
+ line="385">Options controlling prune process
Stop traversal after this many iterations (-1 for unlimited)
+ line="386">Stop traversal after this many iterations (-1 for unlimited)
transfer-ownership="full">
Number of objects found
+ line="387">Number of objects found
transfer-ownership="full">
Number of objects deleted
+ line="388">Number of objects deleted
transfer-ownership="full">
Storage size in bytes of objects deleted
+ line="389">Storage size in bytes of objects deleted
allow-none="1">
Cancellable
+ line="390">Cancellable
@@ -7471,7 +7498,7 @@ Locking: exclusive
throws="1">
Delete content from the repository. This function is the "backend"
+ line="477">Delete content from the repository. This function is the "backend"
half of the higher level ostree_repo_prune(). To use this function,
you determine the root set yourself, and this function finds all other
unreferenced objects and deletes them.
@@ -7484,7 +7511,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
-
+
@@ -7492,13 +7519,13 @@ Locking: exclusive
Repo
+ line="479">Repo
Options controlling prune process
+ line="480">Options controlling prune process
transfer-ownership="full">
Number of objects found
+ line="481">Number of objects found
transfer-ownership="full">
Number of objects deleted
+ line="482">Number of objects deleted
transfer-ownership="full">
Storage size in bytes of objects deleted
+ line="483">Storage size in bytes of objects deleted
allow-none="1">
Cancellable
+ line="484">Cancellable
@@ -7544,12 +7571,12 @@ Locking: exclusive
throws="1">
Prune static deltas, if COMMIT is specified then delete static delta files only
+ line="193">Prune static deltas, if COMMIT is specified then delete static delta files only
targeting that commit; otherwise any static delta of non existing commits are
deleted.
Locking: exclusive
-
+
@@ -7557,7 +7584,7 @@ Locking: exclusive
Repo
+ line="195">Repo
allow-none="1">
ASCII SHA256 checksum for commit, or %NULL for each
+ line="196">ASCII SHA256 checksum for commit, or %NULL for each
non existing commit
@@ -7576,7 +7603,7 @@ non existing commit
allow-none="1">
Cancellable
+ line="198">Cancellable
@@ -7584,7 +7611,7 @@ non existing commit
Connect to the remote repository, fetching the specified set of
+ line="5009">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.
@@ -7600,7 +7627,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.
-
+
@@ -7608,13 +7635,13 @@ one around this call.
Repo
+ line="5011">Repo
Name of remote
+ line="5012">Name of remote
allow-none="1">
Optional list of refs; if %NULL, fetch all configured refs
+ line="5013">Optional list of refs; if %NULL, fetch all configured refs
@@ -7631,7 +7658,7 @@ one around this call.
Options controlling fetch behavior
+ line="5014">Options controlling fetch behavior
allow-none="1">
Progress
+ line="5015">Progress
allow-none="1">
Cancellable
+ line="5016">Cancellable
@@ -7659,7 +7686,7 @@ one around this call.
version="2018.6">
Pull refs from multiple remotes which have been found using
+ line="6274">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
@@ -7701,7 +7728,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
-
+
@@ -7709,13 +7736,13 @@ The following @options are currently defined:
an #OstreeRepo
+ line="6276">an #OstreeRepo
%NULL-terminated array of remotes to
+ line="6277">%NULL-terminated array of remotes to
pull from, including the refs to pull from each
@@ -7727,7 +7754,7 @@ The following @options are currently defined:
allow-none="1">
A GVariant `a{sv}` with an extensible set of flags
+ line="6279">A GVariant `a{sv}` with an extensible set of flags
an #OstreeAsyncProgress to update with the operation’s
+ line="6280">an #OstreeAsyncProgress to update with the operation’s
progress, or %NULL
@@ -7746,7 +7773,7 @@ The following @options are currently defined:
allow-none="1">
a #GCancellable, or %NULL
+ line="6282">a #GCancellable, or %NULL
asynchronous completion callback
+ line="6283">asynchronous completion callback
data to pass to @callback
+ line="6284">data to pass to @callback
@@ -7777,26 +7804,26 @@ The following @options are currently defined:
throws="1">
Finish an asynchronous pull operation started with
+ line="6527">Finish an asynchronous pull operation started with
ostree_repo_pull_from_remotes_async().
-
+
%TRUE on success, %FALSE otherwise
+ line="6536">%TRUE on success, %FALSE otherwise
an #OstreeRepo
+ line="6529">an #OstreeRepo
the asynchronous result
+ line="6530">the asynchronous result
@@ -7806,9 +7833,9 @@ ostree_repo_pull_from_remotes_async().
throws="1">
This is similar to ostree_repo_pull(), but only fetches a single
+ line="5048">This is similar to ostree_repo_pull(), but only fetches a single
subpath.
-
+
@@ -7816,19 +7843,19 @@ subpath.
Repo
+ line="5050">Repo
Name of remote
+ line="5051">Name of remote
Subdirectory path
+ line="5052">Subdirectory path
allow-none="1">
Optional list of refs; if %NULL, fetch all configured refs
+ line="5053">Optional list of refs; if %NULL, fetch all configured refs
@@ -7845,7 +7872,7 @@ subpath.
Options controlling fetch behavior
+ line="5054">Options controlling fetch behavior
allow-none="1">
Progress
+ line="5055">Progress
allow-none="1">
Cancellable
+ line="5056">Cancellable
@@ -7873,7 +7900,7 @@ subpath.
throws="1">
Like ostree_repo_pull(), but supports an extensible set of flags.
+ line="3651">Like ostree_repo_pull(), but supports an extensible set of flags.
The following are currently defined:
* `refs` (`as`): Array of string refs
@@ -7924,7 +7951,7 @@ The following are currently defined:
is specified, `summary-bytes` must also be specified. Since: 2020.5
* `disable-verify-bindings` (`b`): Disable verification of commit bindings.
Since: 2020.9
-
+
@@ -7932,19 +7959,19 @@ The following are currently defined:
Repo
+ line="3653">Repo
Name of remote or file:// url
+ line="3654">Name of remote or file:// url
A GVariant a{sv} with an extensible set of flags.
+ line="3655">A GVariant a{sv} with an extensible set of flags.
Progress
+ line="3656">Progress
Cancellable
+ line="3657">Cancellable
@@ -7972,9 +7999,9 @@ The following are currently defined:
throws="1">
Return the size in bytes of object with checksum @sha256, after any
+ line="4771">Return the size in bytes of object with checksum @sha256, after any
compression has been applied.
-
+
@@ -7982,19 +8009,19 @@ compression has been applied.
Repo
+ line="4773">Repo
Object type
+ line="4774">Object type
Checksum
+ line="4775">Checksum
transfer-ownership="full">
Size in bytes object occupies physically
+ line="4776">Size in bytes object occupies physically
allow-none="1">
Cancellable
+ line="4777">Cancellable
@@ -8022,8 +8049,8 @@ compression has been applied.
throws="1">
Load the content for @rev into @out_root.
-
+ line="4974">Load the content for @rev into @out_root.
+
@@ -8031,13 +8058,13 @@ compression has been applied.
Repo
+ line="4976">Repo
Ref or ASCII checksum
+ line="4977">Ref or ASCII checksum
transfer-ownership="full">
An #OstreeRepoFile corresponding to the root
+ line="4978">An #OstreeRepoFile corresponding to the root
transfer-ownership="full">
The resolved commit checksum
+ line="4979">The resolved commit checksum
allow-none="1">
Cancellable
+ line="4980">Cancellable
@@ -8074,10 +8101,10 @@ compression has been applied.
throws="1">
OSTree commits can have arbitrary metadata associated; this
+ line="3141">OSTree commits can have arbitrary metadata associated; this
function retrieves them. If none exists, @out_metadata will be set
to %NULL.
-
+
@@ -8085,13 +8112,13 @@ to %NULL.
Repo
+ line="3143">Repo
ASCII SHA256 commit checksum
+ line="3144">ASCII SHA256 commit checksum
nullable="1">
Metadata associated with commit in with format "a{sv}", or %NULL if none exists
+ line="3145">Metadata associated with commit in with format "a{sv}", or %NULL if none exists
allow-none="1">
Cancellable
+ line="3146">Cancellable
@@ -8120,7 +8147,7 @@ to %NULL.
throws="1">
An OSTree repository can contain a high level "summary" file that
+ line="6135">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
@@ -8137,8 +8164,8 @@ file, listed under the %OSTREE_SUMMARY_COLLECTION_MAP key. Collection IDs
and refs in %OSTREE_SUMMARY_COLLECTION_MAP are guaranteed to be in
lexicographic order.
-Locking: exclusive
-
+Locking: shared (Prior to 2021.7, this was exclusive)
+
@@ -8146,7 +8173,7 @@ Locking: exclusive
Repo
+ line="6137">Repo
allow-none="1">
A GVariant of type a{sv}, or %NULL
+ line="6138">A GVariant of type a{sv}, or %NULL
allow-none="1">
Cancellable
+ line="6139">Cancellable
@@ -8175,9 +8202,9 @@ Locking: exclusive
throws="1">
By default, an #OstreeRepo will cache the remote configuration and its
+ line="3501">By default, an #OstreeRepo will cache the remote configuration and its
own repo/config data. This API can be used to reload it.
-
+
@@ -8185,7 +8212,7 @@ own repo/config data. This API can be used to reload it.
repo
+ line="3503">repo
allow-none="1">
cancellable
+ line="3504">cancellable
@@ -8204,14 +8231,14 @@ 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="1820">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:
* s: g_key_file_set_string()
* b: g_key_file_set_boolean()
* as: g_key_file_set_string_list()
-
+
@@ -8219,13 +8246,13 @@ mapped as follows:
Repo
+ line="1822">Repo
Name of remote
+ line="1823">Name of remote
URL for remote (if URL begins with metalink=, it will be used as such)
+ line="1824">URL for remote (if URL begins with metalink=, it will be used as such)
GVariant of type a{sv}
+ line="1825">GVariant of type a{sv}
Cancellable
+ line="1826">Cancellable
@@ -8262,10 +8289,10 @@ mapped as follows:
throws="1">
A combined function handling the equivalent of
+ line="2010">A combined function handling the equivalent of
ostree_repo_remote_add(), ostree_repo_remote_delete(), with more
options.
-
+
@@ -8273,7 +8300,7 @@ options.
Repo
+ line="2012">Repo
allow-none="1">
System root
+ line="2013">System root
Operation to perform
+ line="2014">Operation to perform
Name of remote
+ line="2015">Name of remote
allow-none="1">
URL for remote (if URL begins with metalink=, it will be used as such)
+ line="2016">URL for remote (if URL begins with metalink=, it will be used as such)
allow-none="1">
GVariant of type a{sv}
+ line="2017">GVariant of type a{sv}
allow-none="1">
Cancellable
+ line="2018">Cancellable
@@ -8331,9 +8358,9 @@ options.
throws="1">
Delete the remote named @name. It is an error if the provided
+ line="1906">Delete the remote named @name. It is an error if the provided
remote does not exist.
-
+
@@ -8341,13 +8368,13 @@ remote does not exist.
Repo
+ line="1908">Repo
Name of remote
+ line="1909">Name of remote
allow-none="1">
Cancellable
+ line="1910">Cancellable
@@ -8366,7 +8393,7 @@ remote does not exist.
throws="1">
Tries to fetch the summary file and any GPG signatures on the summary file
+ line="2641">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.
@@ -8379,24 +8406,24 @@ Use ostree_repo_verify_summary() for that.
Parse the summary data into a #GVariant using g_variant_new_from_bytes()
with #OSTREE_SUMMARY_GVARIANT_FORMAT as the format string.
-
+
%TRUE on success, %FALSE on failure
+ line="2666">%TRUE on success, %FALSE on failure
Self
+ line="2643">Self
name of a remote
+ line="2644">name of a remote
allow-none="1">
return location for raw summary data, or
+ line="2645">return location for raw summary data, or
%NULL
@@ -8419,7 +8446,7 @@ with #OSTREE_SUMMARY_GVARIANT_FORMAT as the format string.
allow-none="1">
return location for raw summary
+ line="2647">return location for raw summary
signature data, or %NULL
@@ -8429,7 +8456,7 @@ with #OSTREE_SUMMARY_GVARIANT_FORMAT as the format string.
allow-none="1">
a #GCancellable
+ line="2649">a #GCancellable
@@ -8440,7 +8467,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="6552">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
@@ -8449,24 +8476,24 @@ The following are currently defined:
- n-network-retries (u): Number of times to retry each download on receiving
a transient network error, such as a socket timeout; default is 5, 0
means return errors without retrying
-
+
%TRUE on success, %FALSE on failure
+ line="6574">%TRUE on success, %FALSE on failure
Self
+ line="6554">Self
name of a remote
+ line="6555">name of a remote
A GVariant a{sv} with an extensible set of flags
+ line="6556">A GVariant a{sv} with an extensible set of flags
return location for raw summary data, or
+ line="6557">return location for raw summary data, or
%NULL
@@ -8498,7 +8525,7 @@ The following are currently defined:
allow-none="1">
return location for raw summary
+ line="6559">return location for raw summary
signature data, or %NULL
@@ -8508,7 +8535,7 @@ The following are currently defined:
allow-none="1">
a #GCancellable
+ line="6561">a #GCancellable
@@ -8519,24 +8546,24 @@ The following are currently defined:
throws="1">
Enumerate the trusted GPG keys for the remote @name. If @name is
+ line="2513">Enumerate the trusted GPG keys for the remote @name. If @name is
%NULL, the global GPG keys will be returned. The keys will be
returned in the @out_keys #GPtrArray. Each element in the array is a
#GVariant of format %OSTREE_GPG_KEY_GVARIANT_FORMAT. The @key_ids
array can be used to limit which keys are included. If @key_ids is
%NULL, then all keys are included.
-
+
%TRUE if the GPG keys could be enumerated, %FALSE otherwise
+ line="2532">%TRUE if the GPG keys could be enumerated, %FALSE otherwise
an #OstreeRepo
+ line="2515">an #OstreeRepo
name of the remote or %NULL
+ line="2516">name of the remote or %NULL
+ line="2517">
a %NULL-terminated array of GPG key IDs to include, or %NULL
@@ -8568,7 +8595,7 @@ array can be used to limit which keys are included. If @key_ids is
allow-none="1">
+ line="2519">
return location for a #GPtrArray of the remote's trusted GPG keys, or
%NULL
@@ -8581,7 +8608,7 @@ array can be used to limit which keys are included. If @key_ids is
allow-none="1">
a #GCancellable, or %NULL
+ line="2522">a #GCancellable, or %NULL
@@ -8591,27 +8618,27 @@ array can be used to limit which keys are included. If @key_ids is
throws="1">
Return whether GPG verification is enabled for the remote named @name
+ line="2171">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="2182">%TRUE on success, %FALSE on failure
Repo
+ line="2173">Repo
Name of remote
+ line="2174">Name of remote
allow-none="1">
Remote's GPG option
+ line="2175">Remote's GPG option
@@ -8632,95 +8659,10 @@ not exist.
throws="1">
Return whether GPG verification of the summary is enabled for the remote
+ line="2205">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
-
-
-
-
- Repo
-
-
-
- Name of remote
-
-
-
- Remote's GPG option
-
-
-
-
-
- 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
-
-
-
-
- Repo
-
-
-
- Name of remote
-
-
-
- Remote's URL
-
-
-
-
-
- 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.
-
+
Self
+ line="2207">Repo
name of a remote
+ line="2208">Name of remote
+
+
+
+ Remote's GPG option
+
+
+
+
+
+ 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
+
+
+
+
+ Repo
+
+
+
+ Name of remote
+
+
+
+ Remote's URL
+
+
+
+
+
+ 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
+
+
+
+
+ Self
+
+
+
+ name of a remote
allow-none="1">
a #GInputStream, or %NULL
+ line="2232">a #GInputStream, or %NULL
allow-none="1">
a %NULL-terminated array of GPG key IDs, or %NULL
+ line="2233">a %NULL-terminated array of GPG key IDs, or %NULL
@@ -8768,7 +8795,7 @@ from the remote named @name.
allow-none="1">
return location for the number of imported
+ line="2234">return location for the number of imported
keys, or %NULL
@@ -8778,7 +8805,7 @@ from the remote named @name.
allow-none="1">
a #GCancellable
+ line="2236">a #GCancellable
@@ -8786,13 +8813,13 @@ from the remote named @name.
List available remote names in an #OstreeRepo. Remote names are sorted
+ line="2077">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="2085">a %NULL-terminated
array of remote names
@@ -8802,7 +8829,7 @@ alphabetically. If no remotes are available the function returns %NULL.
Repo
+ line="2079">Repo
allow-none="1">
Number of remotes available
+ line="2080">Number of remotes available
@@ -8824,13 +8851,13 @@ alphabetically. If no remotes are available the function returns %NULL.
throws="1">
List refs advertised by @remote_name, including refs which are part of
+ line="989">List refs advertised by @remote_name, including refs which are part of
collections. If the repository at @remote_name has a collection ID set, its
refs will be returned with that collection ID; otherwise, they will be returned
with a %NULL collection ID in each #OstreeCollectionRef key in @out_all_refs.
Any refs for other collections stored in the repository will also be returned.
No filtering is performed.
-
+
@@ -8838,13 +8865,13 @@ No filtering is performed.
Repo
+ line="991">Repo
Name of the remote.
+ line="992">Name of the remote.
transfer-ownership="container">
+ line="993">
Mapping from collection–ref to checksum
@@ -8866,7 +8893,7 @@ No filtering is performed.
allow-none="1">
Cancellable
+ line="995">Cancellable
@@ -8874,7 +8901,7 @@ No filtering is performed.
-
+
@@ -8882,13 +8909,13 @@ No filtering is performed.
Repo
+ line="876">Repo
Name of the remote.
+ line="877">Name of the remote.
transfer-ownership="container">
+ line="878">
Mapping from ref to checksum
@@ -8910,7 +8937,7 @@ No filtering is performed.
allow-none="1">
Cancellable
+ line="880">Cancellable
@@ -8921,7 +8948,7 @@ No filtering is performed.
throws="1">
Look up the checksum for the given collection–ref, returning it in @out_rev.
+ line="496">Look up the checksum for the given collection–ref, returning it in @out_rev.
This will search through the mirrors and remote refs.
If @allow_noent is %TRUE and the given @ref cannot be found, %TRUE will be
@@ -8932,36 +8959,36 @@ returned.
If you want to check only local refs, not remote or mirrored ones, use the
flag %OSTREE_REPO_RESOLVE_REV_EXT_LOCAL_ONLY. This is analogous to using
ostree_repo_resolve_rev_ext() but for collection-refs.
-
+
%TRUE on success, %FALSE on failure
+ line="520">%TRUE on success, %FALSE on failure
an #OstreeRepo
+ line="498">an #OstreeRepo
a collection–ref to resolve
+ line="499">a collection–ref to resolve
%TRUE to not throw an error if @ref doesn’t exist
+ line="500">%TRUE to not throw an error if @ref doesn’t exist
options controlling behaviour
+ line="501">options controlling behaviour
@@ -8974,7 +9001,7 @@ ostree_repo_resolve_rev_ext() but for collection-refs.
allow-none="1">
return location for
+ line="502">return location for
the checksum corresponding to @ref, or %NULL if @allow_noent is %TRUE and
the @ref could not be found
@@ -8985,7 +9012,7 @@ ostree_repo_resolve_rev_ext() but for collection-refs.
allow-none="1">
a #GCancellable, or %NULL
+ line="505">a #GCancellable, or %NULL
@@ -8996,7 +9023,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="1437">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.
@@ -9006,11 +9033,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="1455">#OstreeRemote containing the GPG keyring for
@collection_id
@@ -9018,13 +9045,13 @@ If no match can be found, a %G_IO_ERROR_NOT_FOUND error will be returned.
an #OstreeRepo
+ line="1439">an #OstreeRepo
the collection ID to look up a keyring for
+ line="1440">the collection ID to look up a keyring for
allow-none="1">
a #GCancellable, or %NULL
+ line="1441">a #GCancellable, or %NULL
@@ -9043,10 +9070,10 @@ If no match can be found, a %G_IO_ERROR_NOT_FOUND error will be returned.
throws="1">
Look up the given refspec, returning the checksum it references in
+ line="444">Look up the given refspec, returning the checksum it references in
the parameter @out_rev. Will fall back on remote directory if cannot
find the given refspec in local.
-
+
@@ -9054,19 +9081,19 @@ find the given refspec in local.
Repo
+ line="446">Repo
A refspec
+ line="447">A refspec
Do not throw an error if refspec does not exist
+ line="448">Do not throw an error if refspec does not exist
nullable="1">
A checksum,or %NULL if @allow_noent is true and it does not exist
+ line="449">A checksum,or %NULL if @allow_noent is true and it does not exist
@@ -9087,14 +9114,14 @@ find the given refspec in local.
throws="1">
Look up the given refspec, returning the checksum it references in
+ line="466">Look up the given refspec, returning the checksum it references in
the parameter @out_rev. Differently from ostree_repo_resolve_rev(),
this will not fall back to searching through remote repos if a
local ref is specified but not found.
The flag %OSTREE_REPO_RESOLVE_REV_EXT_LOCAL_ONLY is implied so
using it has no effect.
-
+
@@ -9102,25 +9129,25 @@ using it has no effect.
Repo
+ line="468">Repo
A refspec
+ line="469">A refspec
Do not throw an error if refspec does not exist
+ line="470">Do not throw an error if refspec does not exist
Options controlling behavior
+ line="471">Options controlling behavior
@@ -9131,7 +9158,7 @@ using it has no effect.
nullable="1">
A checksum,or %NULL if @allow_noent is true and it does not exist
+ line="472">A checksum,or %NULL if @allow_noent is true and it does not exist
@@ -9141,7 +9168,7 @@ using it has no effect.
throws="1">
This function is deprecated in favor of using ostree_repo_devino_cache_new(),
+ line="1608">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()`.
@@ -9158,7 +9185,7 @@ before you call ostree_repo_write_directory_to_mtree() or similar. However,
ostree_repo_devino_cache_new() is better as it avoids scanning all objects.
Multithreading: This function is *not* MT safe.
-
+
@@ -9166,7 +9193,7 @@ Multithreading: This function is *not* MT safe.
An #OstreeRepo
+ line="1610">An #OstreeRepo
allow-none="1">
Cancellable
+ line="1611">Cancellable
@@ -9186,8 +9213,8 @@ Multithreading: This function is *not* MT safe.
throws="1">
Like ostree_repo_set_ref_immediate(), but creates an alias.
-
+ line="2221">Like ostree_repo_set_ref_immediate(), but creates an alias.
+
@@ -9195,7 +9222,7 @@ Multithreading: This function is *not* MT safe.
An #OstreeRepo
+ line="2223">An #OstreeRepo
allow-none="1">
A remote for the ref
+ line="2224">A remote for the ref
The ref to write
+ line="2225">The ref to write
allow-none="1">
The ref target to point it to, or %NULL to unset
+ line="2226">The ref target to point it to, or %NULL to unset
allow-none="1">
GCancellable
+ line="2227">GCancellable
@@ -9239,11 +9266,11 @@ Multithreading: This function is *not* MT safe.
throws="1">
Set a custom location for the cache directory used for e.g.
+ line="3662">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.
-
+
@@ -9251,19 +9278,19 @@ write permissions in the repo, where the cache is normally stored.
An #OstreeRepo
+ line="3664">An #OstreeRepo
directory fd
+ line="3665">directory fd
subpath in @dfd
+ line="3666">subpath in @dfd
allow-none="1">
a #GCancellable
+ line="3667">a #GCancellable
@@ -9283,21 +9310,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="6619">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="6629">%TRUE on success, %FALSE otherwise
an #OstreeRepo
+ line="6621">an #OstreeRepo
allow-none="1">
new collection ID, or %NULL to unset it
+ line="6622">new collection ID, or %NULL to unset it
@@ -9317,27 +9344,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="2247">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="2259">%TRUE on success, %FALSE otherwise
An #OstreeRepo
+ line="2249">An #OstreeRepo
The collection–ref to write
+ line="2250">The collection–ref to write
allow-none="1">
The checksum to point it to, or %NULL to unset
+ line="2251">The checksum to point it to, or %NULL to unset
allow-none="1">
GCancellable
+ line="2252">GCancellable
@@ -9364,11 +9391,11 @@ 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="3645">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.
-
+
@@ -9376,13 +9403,13 @@ ensuring data consistency.
An #OstreeRepo
+ line="3647">An #OstreeRepo
If %TRUE, do not fsync
+ line="3648">If %TRUE, do not fsync
@@ -9392,12 +9419,12 @@ ensuring data consistency.
throws="1">
This is like ostree_repo_transaction_set_ref(), except it may be
+ line="2193">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.
Multithreading: This function is MT safe.
-
+
@@ -9405,7 +9432,7 @@ Multithreading: This function is MT safe.
An #OstreeRepo
+ line="2195">An #OstreeRepo
allow-none="1">
A remote for the ref
+ line="2196">A remote for the ref
The ref to write
+ line="2197">The ref to write
allow-none="1">
The checksum to point it to, or %NULL to unset
+ line="2198">The checksum to point it to, or %NULL to unset
allow-none="1">
GCancellable
+ line="2199">GCancellable
@@ -9448,8 +9475,8 @@ Multithreading: This function is MT safe.
throws="1">
Add a GPG signature to a commit.
-
+ line="5376">Add a GPG signature to a commit.
+
@@ -9457,19 +9484,19 @@ Multithreading: This function is MT safe.
Self
+ line="5378">Self
SHA256 of given commit to sign
+ line="5379">SHA256 of given commit to sign
Use this GPG key id
+ line="5380">Use this GPG key id
allow-none="1">
GPG home directory, or %NULL
+ line="5381">GPG home directory, or %NULL
allow-none="1">
A #GCancellable
+ line="5382">A #GCancellable
@@ -9497,9 +9524,9 @@ Multithreading: This function is MT safe.
throws="1">
This function is deprecated, sign the summary file instead.
+ line="5465">This function is deprecated, sign the summary file instead.
Add a GPG signature to a static delta.
-
+
@@ -9507,31 +9534,31 @@ Add a GPG signature to a static delta.
Self
+ line="5467">Self
From commit
+ line="5468">From commit
To commit
+ line="5469">To commit
key id
+ line="5470">key id
homedir
+ line="5471">homedir
allow-none="1">
cancellable
+ line="5472">cancellable
@@ -9550,10 +9577,10 @@ Add a GPG signature to a static delta.
throws="1">
Validate the commit data using the commit metadata which must
+ line="357">Validate the commit data using the commit metadata which must
contain at least one valid signature. If GPG and signapi are
both enabled, then both must find at least one valid signature.
-
+
@@ -9561,31 +9588,31 @@ both enabled, then both must find at least one valid signature.
Repo
+ line="359">Repo
Name of remote
+ line="360">Name of remote
Commit object data (GVariant)
+ line="361">Commit object data (GVariant)
Commit metadata (GVariant `a{sv}`), must contain at least one valid signature
+ line="362">Commit metadata (GVariant `a{sv}`), must contain at least one valid signature
Optionally disable GPG or signapi
+ line="363">Optionally disable GPG or signapi
nullable="1">
Textual description of results
+ line="364">Textual description of results
@@ -9605,11 +9632,11 @@ both enabled, then both must find at least one valid signature.
throws="1">
Given a directory representing an already-downloaded static delta
+ line="634">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.
-
+
@@ -9617,19 +9644,19 @@ must contain a file named "superblock", along with at least one part.
Repo
+ line="636">Repo
Path to a directory containing static delta data, or directly to the superblock
+ line="637">Path to a directory containing static delta data, or directly to the superblock
If %TRUE, assume data integrity
+ line="638">If %TRUE, assume data integrity
allow-none="1">
Cancellable
+ line="639">Cancellable
@@ -9649,7 +9676,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="388">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,
@@ -9657,7 +9684,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.
-
+
@@ -9665,25 +9692,25 @@ one part.
Repo
+ line="390">Repo
Path to a directory containing static delta data, or directly to the superblock
+ line="391">Path to a directory containing static delta data, or directly to the superblock
Signature engine used to check superblock
+ line="392">Signature engine used to check superblock
If %TRUE, assume data integrity
+ line="393">If %TRUE, assume data integrity
allow-none="1">
Cancellable
+ line="394">Cancellable
@@ -9702,7 +9729,7 @@ one part.
throws="1">
Generate a lookaside "static delta" from @from (%NULL means
+ line="1310">Generate a lookaside "static delta" from @from (%NULL means
from-empty) which can generate the objects in @to. This delta is
an optimization over fetching individual objects, and can be
conveniently stored and applied offline.
@@ -9721,7 +9748,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.
-
+
@@ -9729,13 +9756,13 @@ are known:
Repo
+ line="1312">Repo
High level optimization choice
+ line="1313">High level optimization choice
@@ -9745,13 +9772,13 @@ are known:
allow-none="1">
ASCII SHA256 checksum of origin, or %NULL
+ line="1314">ASCII SHA256 checksum of origin, or %NULL
ASCII SHA256 checksum of target
+ line="1315">ASCII SHA256 checksum of target
Optional metadata
+ line="1316">Optional metadata
Parameters, see below
+ line="1317">Parameters, see below
Cancellable
+ line="1318">Cancellable
@@ -9789,7 +9816,7 @@ are known:
throws="1">
The delta index for a particular commit lists all the existing deltas that can be used
+ line="1245">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).
@@ -9797,7 +9824,7 @@ 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
-
+
@@ -9805,20 +9832,20 @@ Locking: shared
Repo
+ line="1247">Repo
Flags affecting the indexing operation
+ line="1248">Flags affecting the indexing operation
ASCII SHA256 checksum of target commit, or %NULL to index all targets
+ line="1249">ASCII SHA256 checksum of target commit, or %NULL to index all targets
allow-none="1">
Cancellable
+ line="1250">Cancellable
@@ -9838,12 +9865,12 @@ Locking: shared
throws="1">
Verify static delta file signature.
-
+ line="1165">Verify static delta file signature.
+
TRUE if the signature of static delta file is valid using the
+ line="1175">TRUE if the signature of static delta file is valid using the
signature engine provided, FALSE otherwise.
@@ -9851,19 +9878,19 @@ signature engine provided, FALSE otherwise.
Repo
+ line="1167">Repo
delta path
+ line="1168">delta path
Signature engine used to check superblock
+ line="1169">Signature engine used to check superblock
allow-none="1">
success message
+ line="1170">success message
@@ -9885,7 +9912,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="2151">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
@@ -9897,7 +9924,7 @@ is instead aborted with ostree_repo_abort_transaction(), no changes will
be made to the repository.
Multithreading: Since v2017.15 this function is MT safe.
-
+
@@ -9905,13 +9932,13 @@ Multithreading: Since v2017.15 this function is MT safe.
An #OstreeRepo
+ line="2153">An #OstreeRepo
The collection–ref to write
+ line="2154">The collection–ref to write
allow-none="1">
The checksum to point it to
+ line="2155">The checksum to point it to
@@ -9929,7 +9956,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="2100">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.
@@ -9950,7 +9977,7 @@ will have been updated. Your application should take care to handle this
case.
Multithreading: Since v2017.15 this function is MT safe.
-
+
@@ -9958,7 +9985,7 @@ Multithreading: Since v2017.15 this function is MT safe.
An #OstreeRepo
+ line="2102">An #OstreeRepo
allow-none="1">
A remote for the ref
+ line="2103">A remote for the ref
The ref to write
+ line="2104">The ref to write
allow-none="1">
The checksum to point it to
+ line="2105">The checksum to point it to
@@ -9991,12 +10018,12 @@ 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="2073">Like ostree_repo_transaction_set_ref(), but takes concatenated
@refspec format as input instead of separate remote and name
arguments.
Multithreading: Since v2017.15 this function is MT safe.
-
+
@@ -10004,13 +10031,13 @@ Multithreading: Since v2017.15 this function is MT safe.
An #OstreeRepo
+ line="2075">An #OstreeRepo
The refspec to write
+ line="2076">The refspec to write
allow-none="1">
The checksum to point it to
+ line="2077">The checksum to point it to
@@ -10029,9 +10056,9 @@ Multithreading: Since v2017.15 this function is MT safe.
throws="1">
Create a new set @out_reachable containing all objects reachable
+ line="703">Create a new set @out_reachable containing all objects reachable
from @commit_checksum, traversing @maxdepth parent commits.
-
+
@@ -10039,19 +10066,19 @@ from @commit_checksum, traversing @maxdepth parent commits.
Repo
+ line="705">Repo
ASCII SHA256 checksum
+ line="706">ASCII SHA256 checksum
Traverse this many parent commits, -1 for unlimited
+ line="707">Traverse this many parent commits, -1 for unlimited
transfer-ownership="container">
Set of reachable objects
+ line="708">Set of reachable objects
@@ -10072,7 +10099,7 @@ from @commit_checksum, traversing @maxdepth parent commits.
allow-none="1">
Cancellable
+ line="709">Cancellable
@@ -10083,9 +10110,9 @@ from @commit_checksum, traversing @maxdepth parent commits.
throws="1">
Update the set @inout_reachable containing all objects reachable
+ line="677">Update the set @inout_reachable containing all objects reachable
from @commit_checksum, traversing @maxdepth parent commits.
-
+
@@ -10093,25 +10120,25 @@ from @commit_checksum, traversing @maxdepth parent commits.
Repo
+ line="679">Repo
ASCII SHA256 checksum
+ line="680">ASCII SHA256 checksum
Traverse this many parent commits, -1 for unlimited
+ line="681">Traverse this many parent commits, -1 for unlimited
Set of reachable objects
+ line="682">Set of reachable objects
@@ -10123,7 +10150,7 @@ from @commit_checksum, traversing @maxdepth parent commits.
allow-none="1">
Cancellable
+ line="683">Cancellable
@@ -10135,13 +10162,13 @@ from @commit_checksum, traversing @maxdepth parent commits.
throws="1">
Update the set @inout_reachable containing all objects reachable
+ line="644">Update the set @inout_reachable containing all objects reachable
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.
-
+
@@ -10149,25 +10176,25 @@ belongs to.
Repo
+ line="646">Repo
ASCII SHA256 checksum
+ line="647">ASCII SHA256 checksum
Traverse this many parent commits, -1 for unlimited
+ line="648">Traverse this many parent commits, -1 for unlimited
Set of reachable objects
+ line="649">Set of reachable objects
@@ -10176,7 +10203,7 @@ belongs to.
Map from object to parent object
+ line="650">Map from object to parent object
@@ -10188,7 +10215,79 @@ belongs to.
allow-none="1">
Cancellable
+ line="651">Cancellable
+
+
+
+
+
+ Update the set @inout_reachable containing all objects reachable
+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.
+
+
+
+
+
+
+ Repo
+
+
+
+ change traversal behaviour according to these flags
+
+
+
+ ASCII SHA256 checksum
+
+
+
+ Traverse this many parent commits, -1 for unlimited
+
+
+
+ Set of reachable objects
+
+
+
+
+
+
+ Map from object to parent object
+
+
+
+
+
+
+ Cancellable
@@ -10199,10 +10298,10 @@ belongs to.
throws="1">
Add all commit objects directly reachable via a ref to @reachable.
+ line="356">Add all commit objects directly reachable via a ref to @reachable.
Locking: shared
-
+
@@ -10210,19 +10309,19 @@ Locking: shared
Repo
+ line="358">Repo
Depth of traversal
+ line="359">Depth of traversal
Set of reachable objects (will be modified)
+ line="360">Set of reachable objects (will be modified)
@@ -10234,7 +10333,7 @@ Locking: shared
allow-none="1">
Cancellable
+ line="361">Cancellable
@@ -10244,26 +10343,26 @@ Locking: shared
throws="1">
Check for a valid GPG signature on commit named by the ASCII
+ line="5878">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="5890">%TRUE if there was a GPG signature from a trusted keyring, otherwise %FALSE
Repository
+ line="5880">Repository
ASCII SHA256 checksum
+ line="5881">ASCII SHA256 checksum
allow-none="1">
Path to directory GPG keyrings; overrides built-in default if given
+ line="5882">Path to directory GPG keyrings; overrides built-in default if given
allow-none="1">
Path to additional keyring file (not a directory)
+ line="5883">Path to additional keyring file (not a directory)
allow-none="1">
Cancellable
+ line="5884">Cancellable
@@ -10300,26 +10399,26 @@ checksum @commit_checksum.
throws="1">
Read GPG signature(s) on the commit named by the ASCII checksum
+ line="5916">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="5928">an #OstreeGpgVerifyResult, or %NULL on error
Repository
+ line="5918">Repository
ASCII SHA256 checksum
+ line="5919">ASCII SHA256 checksum
allow-none="1">
Path to directory GPG keyrings; overrides built-in default if given
+ line="5920">Path to directory GPG keyrings; overrides built-in default if given
allow-none="1">
Path to additional keyring file (not a directory)
+ line="5921">Path to additional keyring file (not a directory)
allow-none="1">
Cancellable
+ line="5922">Cancellable
@@ -10357,33 +10456,33 @@ checksum @commit_checksum.
throws="1">
Read GPG signature(s) on the commit named by the ASCII checksum
+ line="5952">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="5964">an #OstreeGpgVerifyResult, or %NULL on error
Repository
+ line="5954">Repository
ASCII SHA256 checksum
+ line="5955">ASCII SHA256 checksum
OSTree remote to use for configuration
+ line="5956">OSTree remote to use for configuration
allow-none="1">
Cancellable
+ line="5957">Cancellable
@@ -10402,38 +10501,38 @@ configured for @remote.
throws="1">
Verify @signatures for @summary data using GPG keys in the keyring for
+ line="6039">Verify @signatures for @summary data using GPG keys in the keyring for
@remote_name, and return an #OstreeGpgVerifyResult.
-
+
an #OstreeGpgVerifyResult, or %NULL on error
+ line="6051">an #OstreeGpgVerifyResult, or %NULL on error
Repo
+ line="6041">Repo
Name of remote
+ line="6042">Name of remote
Summary data as a #GBytes
+ line="6043">Summary data as a #GBytes
Summary signatures as a #GBytes
+ line="6044">Summary signatures as a #GBytes
allow-none="1">
Cancellable
+ line="6045">Cancellable
@@ -10452,9 +10551,9 @@ configured for @remote.
throws="1">
Import an archive file @archive into the repository, and write its
+ line="971">Import an archive file @archive into the repository, and write its
file structure to @mtree.
-
+
@@ -10462,19 +10561,19 @@ file structure to @mtree.
An #OstreeRepo
+ line="973">An #OstreeRepo
A path to an archive file
+ line="974">A path to an archive file
The #OstreeMutableTree to write to
+ line="975">The #OstreeMutableTree to write to
allow-none="1">
Optional commit modifier
+ line="976">Optional commit modifier
Autocreate parent directories
+ line="977">Autocreate parent directories
allow-none="1">
Cancellable
+ line="978">Cancellable
@@ -10509,9 +10608,9 @@ file structure to @mtree.
throws="1">
Read an archive from @fd and import it into the repository, writing
+ line="1006">Read an archive from @fd and import it into the repository, writing
its file structure to @mtree.
-
+
@@ -10519,19 +10618,19 @@ its file structure to @mtree.
An #OstreeRepo
+ line="1008">An #OstreeRepo
A file descriptor to read the archive from
+ line="1009">A file descriptor to read the archive from
The #OstreeMutableTree to write to
+ line="1010">The #OstreeMutableTree to write to
allow-none="1">
Optional commit modifier
+ line="1011">Optional commit modifier
Autocreate parent directories
+ line="1012">Autocreate parent directories
allow-none="1">
Cancellable
+ line="1013">Cancellable
@@ -10566,13 +10665,13 @@ its file structure to @mtree.
throws="1">
Write a commit metadata object, referencing @root_contents_checksum
+ line="3034">Write a commit metadata object, referencing @root_contents_checksum
and @root_metadata_checksum.
This uses the current time as the commit timestamp, but it can be
overridden with an explicit timestamp via the
[standard](https://reproducible-builds.org/specs/source-date-epoch/)
`SOURCE_DATE_EPOCH` environment flag.
-
+
@@ -10580,7 +10679,7 @@ overridden with an explicit timestamp via the
Repo
+ line="3036">Repo
ASCII SHA256 checksum for parent, or %NULL for none
+ line="3037">ASCII SHA256 checksum for parent, or %NULL for none
Subject
+ line="3038">Subject
Body
+ line="3039">Body
GVariant of type a{sv}, or %NULL for none
+ line="3040">GVariant of type a{sv}, or %NULL for none
The tree to point the commit to
+ line="3041">The tree to point the commit to
Resulting ASCII SHA256 checksum for commit
+ line="3042">Resulting ASCII SHA256 checksum for commit
Cancellable
+ line="3043">Cancellable
@@ -10650,10 +10749,10 @@ overridden with an explicit timestamp via the
throws="1">
Replace any existing metadata associated with commit referred to by
+ line="3191">Replace any existing metadata associated with commit referred to by
@checksum with @metadata. If @metadata is %NULL, then existing
data will be deleted.
-
+
@@ -10661,13 +10760,13 @@ data will be deleted.
Repo
+ line="3193">Repo
ASCII SHA256 commit checksum
+ line="3194">ASCII SHA256 commit checksum
allow-none="1">
Metadata to associate with commit in with format "a{sv}", or %NULL to delete
+ line="3195">Metadata to associate with commit in with format "a{sv}", or %NULL to delete
allow-none="1">
Cancellable
+ line="3196">Cancellable
@@ -10695,9 +10794,9 @@ data will be deleted.
throws="1">
Write a commit metadata object, referencing @root_contents_checksum
+ line="3087">Write a commit metadata object, referencing @root_contents_checksum
and @root_metadata_checksum.
-
+
@@ -10705,7 +10804,7 @@ and @root_metadata_checksum.
Repo
+ line="3089">Repo
allow-none="1">
ASCII SHA256 checksum for parent, or %NULL for none
+ line="3090">ASCII SHA256 checksum for parent, or %NULL for none
allow-none="1">
Subject
+ line="3091">Subject
allow-none="1">
Body
+ line="3092">Body
allow-none="1">
GVariant of type a{sv}, or %NULL for none
+ line="3093">GVariant of type a{sv}, or %NULL for none
The tree to point the commit to
+ line="3094">The tree to point the commit to
The time to use to stamp the commit
+ line="3095">The time to use to stamp the commit
transfer-ownership="full">
Resulting ASCII SHA256 checksum for commit
+ line="3096">Resulting ASCII SHA256 checksum for commit
allow-none="1">
Cancellable
+ line="3097">Cancellable
@@ -10781,8 +10880,8 @@ and @root_metadata_checksum.
throws="1">
Save @new_config in place of this repository's config file.
-
+ line="1630">Save @new_config in place of this repository's config file.
+
@@ -10790,13 +10889,13 @@ and @root_metadata_checksum.
Repo
+ line="1632">Repo
Overwrite the config file with this data
+ line="1633">Overwrite the config file with this data
@@ -10806,10 +10905,10 @@ and @root_metadata_checksum.
throws="1">
Store the content object streamed as @object_input,
+ line="2739">Store the content object streamed as @object_input,
with total length @length. The actual checksum will
be returned as @out_csum.
-
+
@@ -10817,7 +10916,7 @@ be returned as @out_csum.
Repo
+ line="2741">Repo
allow-none="1">
If provided, validate content against this checksum
+ line="2742">If provided, validate content against this checksum
Content object stream
+ line="2743">Content object stream
Length of @object_input
+ line="2744">Length of @object_input
allow-none="1">
Binary checksum
+ line="2745">Binary checksum
@@ -10860,7 +10959,7 @@ be returned as @out_csum.
allow-none="1">
Cancellable
+ line="2746">Cancellable
@@ -10869,9 +10968,9 @@ be returned as @out_csum.
c:identifier="ostree_repo_write_content_async">
Asynchronously store the content object @object. If provided, the
+ line="2957">Asynchronously store the content object @object. If provided, the
checksum @expected_checksum will be verified.
-
+
@@ -10879,7 +10978,7 @@ checksum @expected_checksum will be verified.
Repo
+ line="2959">Repo
allow-none="1">
If provided, validate content against this checksum
+ line="2960">If provided, validate content against this checksum
Input
+ line="2961">Input
Length of @object
+ line="2962">Length of @object
allow-none="1">
Cancellable
+ line="2963">Cancellable
closure="5">
Invoked when content is writed
+ line="2964">Invoked when content is writed
allow-none="1">
User data for @callback
+ line="2965">User data for @callback
@@ -10939,8 +11038,8 @@ checksum @expected_checksum will be verified.
throws="1">
Completes an invocation of ostree_repo_write_content_async().
-
+ line="2998">Completes an invocation of ostree_repo_write_content_async().
+
@@ -10948,13 +11047,13 @@ checksum @expected_checksum will be verified.
a #OstreeRepo
+ line="3000">a #OstreeRepo
a #GAsyncResult
+ line="3001">a #GAsyncResult
transfer-ownership="full">
A binary SHA256 checksum of the content object
+ line="3002">A binary SHA256 checksum of the content object
@@ -10973,12 +11072,12 @@ checksum @expected_checksum will be verified.
throws="1">
Store the content object streamed as @object_input, with total
+ line="2712">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
disk, for example.
-
+
@@ -10986,25 +11085,25 @@ disk, for example.
Repo
+ line="2714">Repo
Store content using this ASCII SHA256 checksum
+ line="2715">Store content using this ASCII SHA256 checksum
Content stream
+ line="2716">Content stream
Length of @object_input
+ line="2717">Length of @object_input
allow-none="1">
Cancellable
+ line="2718">Cancellable
@@ -11023,10 +11122,10 @@ disk, for example.
throws="1">
Store as objects all contents of the directory referred to by @dfd
+ line="4160">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.
-
+
@@ -11034,25 +11133,25 @@ resulting filesystem hierarchy into @mtree.
Repo
+ line="4162">Repo
Directory file descriptor
+ line="4163">Directory file descriptor
Path
+ line="4164">Path
Overlay directory contents into this tree
+ line="4165">Overlay directory contents into this tree
allow-none="1">
Optional modifier
+ line="4166">Optional modifier
@@ -11071,7 +11170,7 @@ resulting filesystem hierarchy into @mtree.
allow-none="1">
Cancellable
+ line="4167">Cancellable
@@ -11081,9 +11180,9 @@ resulting filesystem hierarchy into @mtree.
throws="1">
Store objects for @dir and all children into the repository @self,
+ line="4119">Store objects for @dir and all children into the repository @self,
overlaying the resulting filesystem hierarchy into @mtree.
-
+
@@ -11091,19 +11190,19 @@ overlaying the resulting filesystem hierarchy into @mtree.
Repo
+ line="4121">Repo
Path to a directory
+ line="4122">Path to a directory
Overlay directory contents into this tree
+ line="4123">Overlay directory contents into this tree
allow-none="1">
Optional modifier
+ line="4124">Optional modifier
@@ -11122,7 +11221,7 @@ overlaying the resulting filesystem hierarchy into @mtree.
allow-none="1">
Cancellable
+ line="4125">Cancellable
@@ -11132,12 +11231,12 @@ overlaying the resulting filesystem hierarchy into @mtree.
throws="1">
Store the metadata object @object. Return the checksum
+ line="2446">Store the metadata object @object. Return the checksum
as @out_csum.
If @expected_checksum is not %NULL, verify it against the
computed checksum.
-
+
@@ -11145,13 +11244,13 @@ computed checksum.
Repo
+ line="2448">Repo
Object type
+ line="2449">Object type
allow-none="1">
If provided, validate content against this checksum
+ line="2450">If provided, validate content against this checksum
Metadata
+ line="2451">Metadata
allow-none="1">
Binary checksum
+ line="2452">Binary checksum
@@ -11188,7 +11287,7 @@ computed checksum.
allow-none="1">
Cancellable
+ line="2453">Cancellable
@@ -11197,9 +11296,9 @@ computed checksum.
c:identifier="ostree_repo_write_metadata_async">
Asynchronously store the metadata object @variant. If provided,
+ line="2621">Asynchronously store the metadata object @variant. If provided,
the checksum @expected_checksum will be verified.
-
+
@@ -11207,13 +11306,13 @@ the checksum @expected_checksum will be verified.
Repo
+ line="2623">Repo
Object type
+ line="2624">Object type
allow-none="1">
If provided, validate content against this checksum
+ line="2625">If provided, validate content against this checksum
Metadata
+ line="2626">Metadata
allow-none="1">
Cancellable
+ line="2627">Cancellable
closure="5">
Invoked when metadata is writed
+ line="2628">Invoked when metadata is writed
allow-none="1">
Data for @callback
+ line="2629">Data for @callback
@@ -11267,8 +11366,8 @@ the checksum @expected_checksum will be verified.
throws="1">
Complete a call to ostree_repo_write_metadata_async().
-
+ line="2662">Complete a call to ostree_repo_write_metadata_async().
+
@@ -11276,13 +11375,13 @@ the checksum @expected_checksum will be verified.
Repo
+ line="2664">Repo
Result
+ line="2665">Result
transfer-ownership="full">
Binary checksum value
+ line="2666">Binary checksum value
@@ -11303,9 +11402,9 @@ the checksum @expected_checksum will be verified.
throws="1">
Store the metadata object @variant; the provided @checksum is
+ line="2519">Store the metadata object @variant; the provided @checksum is
trusted.
-
+
@@ -11313,31 +11412,31 @@ trusted.
Repo
+ line="2521">Repo
Object type
+ line="2522">Object type
Store object with this ASCII SHA256 checksum
+ line="2523">Store object with this ASCII SHA256 checksum
Metadata object stream
+ line="2524">Metadata object stream
Length, may be 0 for unknown
+ line="2525">Length, may be 0 for unknown
allow-none="1">
Cancellable
+ line="2526">Cancellable
@@ -11356,9 +11455,9 @@ trusted.
throws="1">
Store the metadata object @variant; the provided @checksum is
+ line="2556">Store the metadata object @variant; the provided @checksum is
trusted.
-
+
@@ -11366,25 +11465,25 @@ trusted.
Repo
+ line="2558">Repo
Object type
+ line="2559">Object type
Store object with this ASCII SHA256 checksum
+ line="2560">Store object with this ASCII SHA256 checksum
Metadata object
+ line="2561">Metadata object
allow-none="1">
Cancellable
+ line="2562">Cancellable
@@ -11403,10 +11502,10 @@ trusted.
throws="1">
Write all metadata objects for @mtree to repo; the resulting
+ line="4210">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.
-
+
@@ -11414,13 +11513,13 @@ the @mtree represented.
Repo
+ line="4212">Repo
Mutable tree
+ line="4213">Mutable tree
transfer-ownership="full">
An #OstreeRepoFile representing @mtree's root.
+ line="4214">An #OstreeRepoFile representing @mtree's root.
allow-none="1">
Cancellable
+ line="4215">Cancellable
@@ -11449,20 +11548,20 @@ the @mtree represented.
throws="1">
Create an `OstreeContentWriter` that allows streaming output into
+ line="2884">Create an `OstreeContentWriter` that allows streaming output into
the repository.
-
+
A new writer, or %NULL on error
+ line="2898">A new writer, or %NULL on error
Repo,
+ line="2886">Repo,
allow-none="1">
Expected checksum (SHA-256 hex string)
+ line="2887">Expected checksum (SHA-256 hex string)
user id
+ line="2888">user id
group id
+ line="2889">group id
Unix file mode
+ line="2890">Unix file mode
Expected content length
+ line="2891">Expected content length
allow-none="1">
Extended attributes (GVariant type `(ayay)`)
+ line="2892">Extended attributes (GVariant type `(ayay)`)
@@ -11515,24 +11614,24 @@ the repository.
throws="1">
Synchronously create a file object from the provided content. This API
+ line="2797">Synchronously create a file object from the provided content. This API
is intended for small files where it is reasonable to buffer the entire
content in memory.
Unlike `ostree_repo_write_content()`, if @expected_checksum is provided,
this function will not check for the presence of the object beforehand.
-
+
Checksum (as a hex string) of the committed file
+ line="2816">Checksum (as a hex string) of the committed file
repo
+ line="2799">repo
allow-none="1">
The expected checksum
+ line="2800">The expected checksum
User id
+ line="2801">User id
Group id
+ line="2802">Group id
File mode
+ line="2803">File mode
allow-none="1">
Extended attributes, GVariant of type (ayay)
+ line="2804">Extended attributes, GVariant of type (ayay)
File contents
+ line="2805">File contents
@@ -11588,7 +11687,7 @@ this function will not check for the presence of the object beforehand.
allow-none="1">
Cancellable
+ line="2806">Cancellable
@@ -11599,22 +11698,22 @@ this function will not check for the presence of the object beforehand.
throws="1">
Synchronously create a symlink object.
+ line="2843">Synchronously create a symlink object.
Unlike `ostree_repo_write_content()`, if @expected_checksum is provided,
this function will not check for the presence of the object beforehand.
-
+
Checksum (as a hex string) of the committed file
+ line="2859">Checksum (as a hex string) of the committed file
repo
+ line="2845">repo
allow-none="1">
The expected checksum
+ line="2846">The expected checksum
User id
+ line="2847">User id
Group id
+ line="2848">Group id
allow-none="1">
Extended attributes, GVariant of type (ayay)
+ line="2849">Extended attributes, GVariant of type (ayay)
Target of the symbolic link
+ line="2850">Target of the symbolic link
allow-none="1">
Cancellable
+ line="2851">Cancellable
@@ -11670,7 +11769,7 @@ this function will not check for the presence of the object beforehand.
transfer-ownership="none">
Path to repository. Note that if this repository was created
+ line="1286">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
@@ -11684,7 +11783,7 @@ use file-descriptor relative operations.
transfer-ownership="none">
Path to directory containing remote definitions. The default is `NULL`.
+ line="1319">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`.
@@ -11697,7 +11796,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="1301">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.
@@ -11709,7 +11808,7 @@ object via `ostree_sysroot_repo()`.
Emitted during a pull operation upon GPG verification (if enabled).
+ line="1337">Emitted during a pull operation upon GPG verification (if enabled).
Applications can connect to this signal to output the verification
results if desired.
@@ -11723,13 +11822,13 @@ is called.
checksum of the signed object
+ line="1340">checksum of the signed object
an #OstreeGpgVerifyResult
+ line="1341">an #OstreeGpgVerifyResult
@@ -11738,12 +11837,12 @@ is called.
An extensible options structure controlling checkout. Ensure that
+ line="972">An extensible options structure controlling checkout. Ensure that
you have entirely zeroed the structure, then set just the desired
options. This is used by ostree_repo_checkout_at() which
supercedes previous separate enumeration usage in
ostree_repo_checkout_tree() and ostree_repo_checkout_tree_at().
-
+
@@ -11810,12 +11909,12 @@ ostree_repo_checkout_tree() and ostree_repo_checkout_tree_at().
version="2017.13">
This function simply assigns @cache to the `devino_to_csum_cache` member of
+ line="1410">This function simply assigns @cache to the `devino_to_csum_cache` member of
@opts; it's only useful for introspection.
Note that cache does *not* have its refcount incremented - the lifetime of
@cache must be equal to or greater than that of @opts.
-
+
@@ -11823,7 +11922,7 @@ Note that cache does *not* have its refcount incremented - the lifetime of
Checkout options
+ line="1412">Checkout options
@@ -11833,7 +11932,7 @@ Note that cache does *not* have its refcount incremented - the lifetime of
allow-none="1">
Devino cache
+ line="1413">Devino cache
@@ -11842,11 +11941,11 @@ Note that cache does *not* have its refcount incremented - the lifetime of
-
+
#OstreeRepoCheckoutFilterResult saying whether or not to checkout this file
+ line="963">#OstreeRepoCheckoutFilterResult saying whether or not to checkout this file
@@ -11854,13 +11953,13 @@ Note that cache does *not* have its refcount incremented - the lifetime of
Repo
+ line="958">Repo
Path to file
+ line="959">Path to file
File information
+ line="960">File information
User data
+ line="961">User data
@@ -11887,37 +11986,37 @@ Note that cache does *not* have its refcount incremented - the lifetime of
-
+
Do checkout this object
+ line="946">Do checkout this object
Ignore this object
+ line="947">Ignore this object
-
+
No special options
+ line="911">No special options
Ignore uid/gid of files
+ line="912">Ignore uid/gid of files
An extensible options structure controlling checkout. Ensure that
+ line="33">An extensible options structure controlling checkout. Ensure that
you have entirely zeroed the structure, then set just the desired
options. This is used by ostree_repo_checkout_tree_at() which
supercedes previous separate enumeration usage in
ostree_repo_checkout_tree().
-
+
@@ -11972,42 +12071,42 @@ ostree_repo_checkout_tree().
-
+
No special options
+ line="921">No special options
When layering checkouts, unlink() and replace existing files, but do not modify existing directories (unless whiteouts are enabled, then directories are replaced)
+ line="922">When layering checkouts, unlink() and replace existing files, but do not modify existing directories (unless whiteouts are enabled, then directories are replaced)
Only add new files/directories
+ line="923">Only add new files/directories
Like UNION_FILES, but error if files are not identical (requires hardlink checkouts)
+ line="924">Like UNION_FILES, but error if files are not identical (requires hardlink checkouts)
-
+
#OstreeRepoCommitFilterResult saying whether or not to commit this file
+ line="667">#OstreeRepoCommitFilterResult saying whether or not to commit this file
@@ -12015,19 +12114,19 @@ ostree_repo_checkout_tree().
Repo
+ line="662">Repo
Path to file
+ line="663">Path to file
File information
+ line="664">File information
closure="3">
User data
+ line="665">User data
-
+
Do commit this object
+ line="652">Do commit this object
Ignore this object
+ line="653">Ignore this object
-
+
@@ -12087,21 +12186,21 @@ ostree_repo_checkout_tree().
c:symbol-prefix="repo_commit_modifier">
A structure allowing control over commits.
-
+ line="698">A structure allowing control over commits.
+
-
+
A new commit modifier.
+ line="4298">A new commit modifier.
Control options for filter
+ line="4293">Control options for filter
@@ -12114,7 +12213,7 @@ ostree_repo_checkout_tree().
destroy="3">
Function that can inspect individual files
+ line="4294">Function that can inspect individual files
allow-none="1">
User data
+ line="4295">User data
scope="async">
A #GDestroyNotify
+ line="4296">A #GDestroyNotify
-
+
@@ -12153,7 +12252,7 @@ ostree_repo_checkout_tree().
version="2017.13">
See the documentation for
+ line="4420">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.
@@ -12163,7 +12262,7 @@ Note if your process has multiple writers, you should use separate
This function will add a reference to @cache without copying - you
should avoid further mutation of the cache.
-
+
@@ -12171,14 +12270,14 @@ should avoid further mutation of the cache.
Modifier
+ line="4422">Modifier
A hash table caching device,inode to checksums
+ line="4423">A hash table caching device,inode to checksums
@@ -12187,7 +12286,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="4370">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
@@ -12195,7 +12294,7 @@ extended attributes provided via
ostree_repo_commit_modifier_set_xattr_callback(). However if both
specify a value for "security.selinux", then the one from the
policy wins.
-
+
@@ -12203,7 +12302,7 @@ policy wins.
An #OstreeRepoCommitModifier
+ line="4372">An #OstreeRepoCommitModifier
@@ -12213,7 +12312,7 @@ policy wins.
allow-none="1">
Policy to use for labeling
+ line="4373">Policy to use for labeling
@@ -12224,10 +12323,10 @@ policy wins.
throws="1">
In many cases, one wants to create a "derived" commit from base commit.
+ line="4392">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.
-
+
@@ -12235,20 +12334,20 @@ one to easily set up SELinux labeling from a base commit.
Commit modifier
+ line="4394">Commit modifier
OSTree repo containing @rev
+ line="4395">OSTree repo containing @rev
Find SELinux policy from this base commit
+ line="4396">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="4347">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.
-
+
@@ -12275,7 +12374,7 @@ repository.
An #OstreeRepoCommitModifier
+ line="4349">An #OstreeRepoCommitModifier
@@ -12286,14 +12385,14 @@ repository.
destroy="1">
Function to be invoked, should return extended attributes for path
+ line="4350">Function to be invoked, should return extended attributes for path
Destroy notification
+ line="4351">Destroy notification
allow-none="1">
Data for @callback:
+ line="4352">Data for @callback:
-
+
@@ -12324,62 +12423,62 @@ repository.
c:type="OstreeRepoCommitModifierFlags">
Flags modifying commit behavior. In bare-user-only mode, @OSTREE_REPO_COMMIT_MODIFIER_FLAGS_CANONICAL_PERMISSIONS
+ line="674">Flags modifying commit behavior. In bare-user-only mode, @OSTREE_REPO_COMMIT_MODIFIER_FLAGS_CANONICAL_PERMISSIONS
and @OSTREE_REPO_COMMIT_MODIFIER_FLAGS_SKIP_XATTRS are automatically enabled.
-
+
No special flags
+ line="676">No special flags
Do not process extended attributes
+ line="677">Do not process extended attributes
Generate size information.
+ line="678">Generate size information.
Canonicalize permissions.
+ line="679">Canonicalize permissions.
Emit an error if configured SELinux policy does not provide a label
+ line="680">Emit an error if configured SELinux policy does not provide a label
Delete added files/directories after commit; Since: 2017.13
+ line="681">Delete added files/directories after commit; Since: 2017.13
If a devino cache hit is found, skip modifier filters (non-directories only); Since: 2017.14
+ line="682">If a devino cache hit is found, skip modifier filters (non-directories only); Since: 2017.14
-
+
@@ -12407,15 +12506,15 @@ and @OSTREE_REPO_COMMIT_MODIFIER_FLAGS_SKIP_XATTRS are automatically enabled.
Flags representing the state of a commit in the local repository, as returned
+ line="250">Flags representing the state of a commit in the local repository, as returned
by ostree_repo_load_commit().
-
+
Commit is complete. This is the default.
+ line="252">Commit is complete. This is the default.
(Since: 2017.14.)
c:identifier="OSTREE_REPO_COMMIT_STATE_PARTIAL">
One or more objects are missing from the
+ line="254">One or more objects are missing from the
local copy of the commit, but metadata is present. (Since: 2015.7.)
c:identifier="OSTREE_REPO_COMMIT_STATE_FSCK_PARTIAL">
One or more objects are missing from the
+ line="256">One or more objects are missing from the
local copy of the commit, due to an fsck --delete. (Since: 2019.4.)
-
-
+
+ No special options for traverse
+
+
+ Traverse and retrieve only commit objects. (Since: 2022.2)
-
+
@@ -12461,7 +12570,7 @@ by ostree_repo_load_commit().
-
+
@@ -12476,10 +12585,10 @@ by ostree_repo_load_commit().
c:identifier="ostree_repo_commit_traverse_iter_get_dir">
Return information on the current directory. This function may
+ line="233">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().
-
+
@@ -12487,7 +12596,7 @@ from ostree_repo_commit_traverse_iter_next().
An iter
+ line="235">An iter
@@ -12497,7 +12606,7 @@ from ostree_repo_commit_traverse_iter_next().
transfer-ownership="none">
Name of current dir
+ line="236">Name of current dir
transfer-ownership="none">
Checksum of current content
+ line="237">Checksum of current content
transfer-ownership="none">
Checksum of current metadata
+ line="238">Checksum of current metadata
@@ -12524,10 +12633,10 @@ from ostree_repo_commit_traverse_iter_next().
c:identifier="ostree_repo_commit_traverse_iter_get_file">
Return information on the current file. This function may only be
+ line="212">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().
-
+
@@ -12535,7 +12644,7 @@ ostree_repo_commit_traverse_iter_next().
An iter
+ line="214">An iter
@@ -12545,7 +12654,7 @@ ostree_repo_commit_traverse_iter_next().
transfer-ownership="none">
Name of current file
+ line="215">Name of current file
transfer-ownership="none">
Checksum of current file
+ line="216">Checksum of current file
@@ -12564,8 +12673,8 @@ ostree_repo_commit_traverse_iter_next().
throws="1">
Initialize (in place) an iterator over the root of a commit object.
-
+ line="40">Initialize (in place) an iterator over the root of a commit object.
+
@@ -12573,26 +12682,26 @@ ostree_repo_commit_traverse_iter_next().
An iter
+ line="42">An iter
A repo
+ line="43">A repo
Variant of type %OSTREE_OBJECT_TYPE_COMMIT
+ line="44">Variant of type %OSTREE_OBJECT_TYPE_COMMIT
Flags
+ line="45">Flags
@@ -12603,8 +12712,8 @@ ostree_repo_commit_traverse_iter_next().
throws="1">
Initialize (in place) an iterator over a directory tree.
-
+ line="84">Initialize (in place) an iterator over a directory tree.
+
@@ -12612,26 +12721,26 @@ ostree_repo_commit_traverse_iter_next().
An iter
+ line="86">An iter
A repo
+ line="87">A repo
Variant of type %OSTREE_OBJECT_TYPE_DIR_TREE
+ line="88">Variant of type %OSTREE_OBJECT_TYPE_DIR_TREE
Flags
+ line="89">Flags
@@ -12642,7 +12751,7 @@ ostree_repo_commit_traverse_iter_next().
throws="1">
Step the interator to the next item. Files will be returned first,
+ line="113">Step the interator to the next item. Files will be returned first,
then subdirectories. Call this in a loop; upon encountering
%OSTREE_REPO_COMMIT_ITER_RESULT_END, there will be no more files or
directories. If %OSTREE_REPO_COMMIT_ITER_RESULT_DIR is returned,
@@ -12654,7 +12763,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().
-
+
@@ -12663,7 +12772,7 @@ ostree_repo_commit_traverse_iter_clear().
An iter
+ line="115">An iter
@@ -12673,14 +12782,14 @@ ostree_repo_commit_traverse_iter_clear().
allow-none="1">
Cancellable
+ line="116">Cancellable
-
+
@@ -12699,27 +12808,27 @@ ostree_repo_commit_traverse_iter_clear().
glib:type-name="OstreeRepoDevInoCache"
glib:get-type="ostree_repo_devino_cache_get_type"
c:symbol-prefix="repo_devino_cache">
-
+
OSTree has support for pairing ostree_repo_checkout_tree_at() using
+ line="1447">OSTree has support for pairing ostree_repo_checkout_tree_at() using
hardlinks in combination with a later
ostree_repo_write_directory_to_mtree() using a (normally modified)
directory. In order for OSTree to optimally detect just the new
files, use this function and fill in the `devino_to_csum_cache`
member of `OstreeRepoCheckoutAtOptions`, then call
ostree_repo_commit_set_devino_cache().
-
+
Newly allocated cache
+ line="1458">Newly allocated cache
-
+
@@ -12730,7 +12839,7 @@ ostree_repo_commit_set_devino_cache().
-
+
@@ -12746,10 +12855,10 @@ ostree_repo_commit_set_devino_cache().
introspectable="0">
An extensible options structure controlling archive creation. Ensure that
+ line="836">An extensible options structure controlling archive creation. Ensure that
you have entirely zeroed the structure, then set just the desired
options. This is used by ostree_repo_export_tree_to_archive().
-
+
@@ -12780,12 +12889,12 @@ options. This is used by ostree_repo_export_tree_to_archive().
glib:type-name="OstreeRepoFile"
glib:get-type="ostree_repo_file_get_type"
glib:type-struct="RepoFileClass">
-
+
-
+
@@ -12796,7 +12905,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
-
+
@@ -12807,11 +12916,11 @@ options. This is used by ostree_repo_export_tree_to_archive().
-
+
Repository
+ line="362">Repository
@@ -12821,11 +12930,11 @@ options. This is used by ostree_repo_export_tree_to_archive().
-
+
The root directory for the commit referenced by this file
+ line="374">The root directory for the commit referenced by this file
@@ -12837,7 +12946,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
-
+
@@ -12845,7 +12954,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
#OstreeRepoFile
+ line="295">#OstreeRepoFile
allow-none="1">
the extended attributes
+ line="296">the extended attributes
allow-none="1">
Cancellable
+ line="297">Cancellable
-
+
@@ -12880,13 +12989,13 @@ options. This is used by ostree_repo_export_tree_to_archive().
#OstreeRepoFile
+ line="734">#OstreeRepoFile
name of the child
+ line="735">name of the child
-
+
@@ -12917,7 +13026,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
-
+
@@ -12929,7 +13038,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
-
+
@@ -12941,7 +13050,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
-
+
@@ -12954,7 +13063,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
-
+
@@ -12962,7 +13071,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
#OstreeRepoFile
+ line="786">#OstreeRepoFile
@@ -12986,14 +13095,14 @@ options. This is used by ostree_repo_export_tree_to_archive().
allow-none="1">
Cancellable
+ line="791">Cancellable
-
+
@@ -13013,7 +13122,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
-
+
@@ -13021,11 +13130,11 @@ options. This is used by ostree_repo_export_tree_to_archive().
-
+
-
+
@@ -13036,15 +13145,15 @@ options. This is used by ostree_repo_export_tree_to_archive().
glib:type-name="OstreeRepoFinder"
glib:get-type="ostree_repo_finder_get_type"
glib:type-struct="RepoFinderInterface">
-
+
A version of ostree_repo_finder_resolve_async() which queries one or more
+ line="243">A version of ostree_repo_finder_resolve_async() which queries one or more
@finders in parallel and combines the results.
-
+
@@ -13052,7 +13161,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
non-empty array of #OstreeRepoFinders
+ line="245">non-empty array of #OstreeRepoFinders
@@ -13060,7 +13169,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
non-empty array of collection–ref pairs to find remotes for
+ line="246">non-empty array of collection–ref pairs to find remotes for
@@ -13068,7 +13177,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
the local repository which the refs are being resolved for,
+ line="247">the local repository which the refs are being resolved for,
which provides configuration information and GPG keys
@@ -13078,7 +13187,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
allow-none="1">
a #GCancellable, or %NULL
+ line="249">a #GCancellable, or %NULL
closure="5">
asynchronous completion callback
+ line="250">asynchronous completion callback
allow-none="1">
data to pass to @callback
+ line="251">data to pass to @callback
@@ -13109,12 +13218,12 @@ options. This is used by ostree_repo_export_tree_to_archive().
throws="1">
Get the results from a ostree_repo_finder_resolve_all_async() operation.
-
+ line="404">Get the results from a ostree_repo_finder_resolve_all_async() operation.
+
array of zero
+ line="411">array of zero
or more results
@@ -13124,7 +13233,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
#GAsyncResult from the callback
+ line="406">#GAsyncResult from the callback
@@ -13134,7 +13243,7 @@ options. This is used by ostree_repo_export_tree_to_archive().
version="2018.6">
Find reachable remote URIs which claim to provide any of the given @refs. The
+ line="107">Find reachable remote URIs which claim to provide any of the given @refs. The
specific method for finding the remotes depends on the #OstreeRepoFinder
implementation.
@@ -13156,7 +13265,7 @@ the checksum will not be set. Results which provide none of the requested
Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
@refs from those remotes.
-
+
@@ -13164,13 +13273,13 @@ Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
an #OstreeRepoFinder
+ line="109">an #OstreeRepoFinder
non-empty array of collection–ref pairs to find remotes for
+ line="110">non-empty array of collection–ref pairs to find remotes for
@@ -13178,7 +13287,7 @@ Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
the local repository which the refs are being resolved for,
+ line="111">the local repository which the refs are being resolved for,
which provides configuration information and GPG keys
@@ -13188,7 +13297,7 @@ Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
allow-none="1">
a #GCancellable, or %NULL
+ line="113">a #GCancellable, or %NULL
asynchronous completion callback
+ line="114">asynchronous completion callback
data to pass to @callback
+ line="115">data to pass to @callback
@@ -13220,12 +13329,12 @@ Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
throws="1">
Get the results from a ostree_repo_finder_resolve_async() operation.
-
+ line="188">Get the results from a ostree_repo_finder_resolve_async() operation.
+
array of zero
+ line="196">array of zero
or more results
@@ -13235,13 +13344,13 @@ Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
an #OstreeRepoFinder
+ line="190">an #OstreeRepoFinder
#GAsyncResult from the callback
+ line="191">#GAsyncResult from the callback
@@ -13251,7 +13360,7 @@ Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
version="2018.6">
Find reachable remote URIs which claim to provide any of the given @refs. The
+ line="107">Find reachable remote URIs which claim to provide any of the given @refs. The
specific method for finding the remotes depends on the #OstreeRepoFinder
implementation.
@@ -13273,7 +13382,7 @@ the checksum will not be set. Results which provide none of the requested
Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
@refs from those remotes.
-
+
@@ -13281,13 +13390,13 @@ Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
an #OstreeRepoFinder
+ line="109">an #OstreeRepoFinder
non-empty array of collection–ref pairs to find remotes for
+ line="110">non-empty array of collection–ref pairs to find remotes for
@@ -13295,7 +13404,7 @@ Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
the local repository which the refs are being resolved for,
+ line="111">the local repository which the refs are being resolved for,
which provides configuration information and GPG keys
@@ -13305,7 +13414,7 @@ Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
allow-none="1">
a #GCancellable, or %NULL
+ line="113">a #GCancellable, or %NULL
asynchronous completion callback
+ line="114">asynchronous completion callback
data to pass to @callback
+ line="115">data to pass to @callback
@@ -13336,12 +13445,12 @@ Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
throws="1">
Get the results from a ostree_repo_finder_resolve_async() operation.
-
+ line="188">Get the results from a ostree_repo_finder_resolve_async() operation.
+
array of zero
+ line="196">array of zero
or more results
@@ -13351,13 +13460,13 @@ Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
an #OstreeRepoFinder
+ line="190">an #OstreeRepoFinder
#GAsyncResult from the callback
+ line="191">#GAsyncResult from the callback
@@ -13370,14 +13479,14 @@ Pass the results to ostree_repo_pull_from_remotes_async() to pull the given
glib:type-name="OstreeRepoFinderAvahi"
glib:get-type="ostree_repo_finder_avahi_get_type"
glib:type-struct="RepoFinderAvahiClass">
-
+
Create a new #OstreeRepoFinderAvahi instance. It is intended that one such
+ line="1358">Create a new #OstreeRepoFinderAvahi instance. It is intended that one such
instance be created per process, and it be used to answer all resolution
requests from #OstreeRepos.
@@ -13386,11 +13495,11 @@ the #OstreeRepoFinderAvahi is running (after ostree_repo_finder_avahi_start()
is called). This may be done from any thread.
If @context is %NULL, the current thread-default #GMainContext is used.
-
+
a new #OstreeRepoFinderAvahi
+ line="1373">a new #OstreeRepoFinderAvahi
@@ -13400,7 +13509,7 @@ If @context is %NULL, the current thread-default #GMainContext is used.
allow-none="1">
a #GMainContext for processing Avahi
+ line="1360">a #GMainContext for processing Avahi
events in, or %NULL to use the current thread-default
@@ -13412,7 +13521,7 @@ If @context is %NULL, the current thread-default #GMainContext is used.
throws="1">
Start monitoring the local network for peers who are advertising OSTree
+ line="1401">Start monitoring the local network for peers who are advertising OSTree
repositories, using Avahi. In order for this to work, the #GMainContext
passed to @self at construction time must be iterated (so it will typically
be the global #GMainContext, or be a separate #GMainContext in a worker
@@ -13428,7 +13537,7 @@ Call ostree_repo_finder_avahi_stop() to stop the repo finder.
It is an error to call this function multiple times on the same
#OstreeRepoFinderAvahi instance, or to call it after
ostree_repo_finder_avahi_stop().
-
+
@@ -13436,7 +13545,7 @@ ostree_repo_finder_avahi_stop().
an #OstreeRepoFinderAvahi
+ line="1403">an #OstreeRepoFinderAvahi
@@ -13446,7 +13555,7 @@ ostree_repo_finder_avahi_stop().
version="2018.6">
Stop monitoring the local network for peers who are advertising OSTree
+ line="1490">Stop monitoring the local network for peers who are advertising OSTree
repositories. If any resolve tasks (from ostree_repo_finder_resolve_async())
are in progress, they will be cancelled and will return %G_IO_ERROR_CANCELLED.
@@ -13455,7 +13564,7 @@ Call ostree_repo_finder_avahi_start() to start the repo finder.
It is an error to call this function multiple times on the same
#OstreeRepoFinderAvahi instance, or to call it before
ostree_repo_finder_avahi_start().
-
+
@@ -13463,7 +13572,7 @@ ostree_repo_finder_avahi_start().
an #OstreeRepoFinderAvahi
+ line="1492">an #OstreeRepoFinderAvahi
@@ -13472,7 +13581,7 @@ ostree_repo_finder_avahi_start().
-
+
@@ -13484,19 +13593,19 @@ ostree_repo_finder_avahi_start().
glib:type-name="OstreeRepoFinderConfig"
glib:get-type="ostree_repo_finder_config_get_type"
glib:type-struct="RepoFinderConfigClass">
-
+
Create a new #OstreeRepoFinderConfig.
-
+ line="229">Create a new #OstreeRepoFinderConfig.
+
a new #OstreeRepoFinderConfig
+ line="234">a new #OstreeRepoFinderConfig
@@ -13504,7 +13613,7 @@ ostree_repo_finder_avahi_start().
-
+
@@ -13512,13 +13621,13 @@ ostree_repo_finder_avahi_start().
-
+
-
+
@@ -13526,13 +13635,13 @@ ostree_repo_finder_avahi_start().
an #OstreeRepoFinder
+ line="109">an #OstreeRepoFinder
non-empty array of collection–ref pairs to find remotes for
+ line="110">non-empty array of collection–ref pairs to find remotes for
@@ -13540,7 +13649,7 @@ ostree_repo_finder_avahi_start().
the local repository which the refs are being resolved for,
+ line="111">the local repository which the refs are being resolved for,
which provides configuration information and GPG keys
@@ -13550,7 +13659,7 @@ ostree_repo_finder_avahi_start().
allow-none="1">
a #GCancellable, or %NULL
+ line="113">a #GCancellable, or %NULL
closure="5">
asynchronous completion callback
+ line="114">asynchronous completion callback
@@ -13572,7 +13681,7 @@ ostree_repo_finder_avahi_start().
closure="5">
data to pass to @callback
+ line="115">data to pass to @callback
@@ -13580,11 +13689,11 @@ ostree_repo_finder_avahi_start().
-
+
array of zero
+ line="196">array of zero
or more results
@@ -13594,13 +13703,13 @@ ostree_repo_finder_avahi_start().
an #OstreeRepoFinder
+ line="190">an #OstreeRepoFinder
#GAsyncResult from the callback
+ line="191">#GAsyncResult from the callback
@@ -13614,21 +13723,21 @@ ostree_repo_finder_avahi_start().
glib:type-name="OstreeRepoFinderMount"
glib:get-type="ostree_repo_finder_mount_get_type"
glib:type-struct="RepoFinderMountClass">
-
+
Create a new #OstreeRepoFinderMount, using the given @monitor to look up
+ line="671">Create a new #OstreeRepoFinderMount, using the given @monitor to look up
volumes. If @monitor is %NULL, the monitor from g_volume_monitor_get() will
be used.
-
+
a new #OstreeRepoFinderMount
+ line="680">a new #OstreeRepoFinderMount
@@ -13638,7 +13747,7 @@ be used.
allow-none="1">
volume monitor to use, or %NULL to use
+ line="673">volume monitor to use, or %NULL to use
the system default
@@ -13651,14 +13760,14 @@ be used.
transfer-ownership="none">
Volume monitor to use to look up mounted volumes when queried.
+ line="645">Volume monitor to use to look up mounted volumes when queried.
-
+
@@ -13670,19 +13779,19 @@ be used.
glib:type-name="OstreeRepoFinderOverride"
glib:get-type="ostree_repo_finder_override_get_type"
glib:type-struct="RepoFinderOverrideClass">
-
+
Create a new #OstreeRepoFinderOverride.
-
+ line="291">Create a new #OstreeRepoFinderOverride.
+
a new #OstreeRepoFinderOverride
+ line="296">a new #OstreeRepoFinderOverride
@@ -13691,9 +13800,9 @@ be used.
version="2018.6">
Add the given @uri to the set of URIs which the repo finder will search for
+ line="305">Add the given @uri to the set of URIs which the repo finder will search for
matching refs when ostree_repo_finder_resolve_async() is called on it.
-
+
@@ -13705,7 +13814,7 @@ matching refs when ostree_repo_finder_resolve_async() is called on it.
URI to add to the repo finder
+ line="307">URI to add to the repo finder
@@ -13714,7 +13823,7 @@ matching refs when ostree_repo_finder_resolve_async() is called on it.
-
+
@@ -13727,7 +13836,7 @@ matching refs when ostree_repo_finder_resolve_async() is called on it.
c:symbol-prefix="repo_finder_result">
#OstreeRepoFinderResult gives a single result from an
+ line="90">#OstreeRepoFinderResult gives a single result from an
ostree_repo_finder_resolve_async() or ostree_repo_finder_resolve_all_async()
operation. This represents a single remote which provides none, some or all
of the refs being resolved. The structure includes various bits of metadata
@@ -13757,31 +13866,31 @@ not, the timestamps are zero when any of the following conditions are met:
(1) the override-commit-ids option was used on
ostree_repo_find_remotes_async (2) there was an error in trying to get the
commit metadata (3) the checksum for this ref is %NULL in @ref_to_checksum.
-
+
#OstreeRemote which contains the transport details for the result,
+ line="92">#OstreeRemote which contains the transport details for the result,
such as its URI and GPG key
the #OstreeRepoFinder instance which produced this result
+ line="94">the #OstreeRepoFinder instance which produced this result
static priority of the result, where higher numbers indicate lower
+ line="95">static priority of the result, where higher numbers indicate lower
priority
map of collection–ref
+ line="97">map of collection–ref
pairs to checksums provided by this remote; values may be %NULL to
indicate this remote doesn’t provide that ref
@@ -13792,14 +13901,14 @@ commit metadata (3) the checksum for this ref is %NULL in @ref_to_checksum.
Unix timestamp (seconds since the epoch, UTC) when
+ line="102">Unix timestamp (seconds since the epoch, UTC) when
the summary file on the remote was last modified, or `0` if unknown
map of
+ line="100">map of
collection–ref pairs to timestamps; values may be 0 for various reasons
@@ -13816,41 +13925,41 @@ commit metadata (3) the checksum for this ref is %NULL in @ref_to_checksum.
Create a new #OstreeRepoFinderResult instance. The semantics for the arguments
+ line="428">Create a new #OstreeRepoFinderResult instance. The semantics for the arguments
are as described in the #OstreeRepoFinderResult documentation.
-
+
a new #OstreeRepoFinderResult
+ line="447">a new #OstreeRepoFinderResult
an #OstreeRemote containing the transport details
+ line="430">an #OstreeRemote containing the transport details
for the result
the #OstreeRepoFinder instance which produced the
+ line="432">the #OstreeRepoFinder instance which produced the
result
static priority of the result, where higher numbers indicate lower
+ line="434">static priority of the result, where higher numbers indicate lower
priority
+ line="436">
map of collection–ref pairs to checksums provided by this result
@@ -13863,7 +13972,7 @@ are as described in the #OstreeRepoFinderResult documentation.
allow-none="1">
map of collection–ref pairs to timestamps provided by this
+ line="438">map of collection–ref pairs to timestamps provided by this
result
@@ -13873,7 +13982,7 @@ are as described in the #OstreeRepoFinderResult documentation.
Unix timestamp (seconds since the epoch, UTC) when
+ line="441">Unix timestamp (seconds since the epoch, UTC) when
the summary file for the result was last modified, or `0` if this is unknown
@@ -13884,13 +13993,13 @@ are as described in the #OstreeRepoFinderResult documentation.
version="2018.6">
Compare two #OstreeRepoFinderResult instances to work out which one is better
+ line="494">Compare two #OstreeRepoFinderResult instances to work out which one is better
to pull from, and hence needs to be ordered before the other.
-
+
<0 if @a is ordered before @b, 0 if they are ordered equally,
+ line="502"><0 if @a is ordered before @b, 0 if they are ordered equally,
>0 if @b is ordered before @a
@@ -13898,14 +14007,14 @@ to pull from, and hence needs to be ordered before the other.
an #OstreeRepoFinderResult
+ line="496">an #OstreeRepoFinderResult
an #OstreeRepoFinderResult
+ line="497">an #OstreeRepoFinderResult
@@ -13916,19 +14025,19 @@ to pull from, and hence needs to be ordered before the other.
version="2018.6">
Copy an #OstreeRepoFinderResult.
-
+ line="475">Copy an #OstreeRepoFinderResult.
+
a newly allocated copy of @result
+ line="481">a newly allocated copy of @result
an #OstreeRepoFinderResult to copy
+ line="477">an #OstreeRepoFinderResult to copy
@@ -13938,8 +14047,8 @@ to pull from, and hence needs to be ordered before the other.
version="2018.6">
Free the given @result.
-
+ line="545">Free the given @result.
+
@@ -13947,7 +14056,7 @@ to pull from, and hence needs to be ordered before the other.
an #OstreeRepoFinderResult
+ line="547">an #OstreeRepoFinderResult
@@ -13957,8 +14066,8 @@ to pull from, and hence needs to be ordered before the other.
version="2018.6">
Free the given @results array, freeing each element and the container.
-
+ line="567">Free the given @results array, freeing each element and the container.
+
@@ -13966,7 +14075,7 @@ to pull from, and hence needs to be ordered before the other.
an #OstreeRepoFinderResult
+ line="569">an #OstreeRepoFinderResult
@@ -13979,10 +14088,10 @@ to pull from, and hence needs to be ordered before the other.
introspectable="0">
An extensible options structure controlling archive import. Ensure that
+ line="807">An extensible options structure controlling archive import. Ensure that
you have entirely zeroed the structure, then set just the desired
options. This is used by ostree_repo_import_archive_to_mtree().
-
+
@@ -14021,7 +14130,7 @@ options. This is used by ostree_repo_import_archive_to_mtree().
version="2017.11">
Possibly change a pathname while importing an archive. If %NULL is returned,
+ line="782">Possibly change a pathname while importing an archive. If %NULL is returned,
then @src_path will be used unchanged. Otherwise, return a new pathname which
will be freed via `g_free()`.
@@ -14031,7 +14140,7 @@ types, first with outer directories, then their sub-files and directories.
Note that enabling pathname translation will always override the setting for
`use_ostree_convention`.
-
+
@@ -14039,7 +14148,7 @@ Note that enabling pathname translation will always override the setting for
Repo
+ line="784">Repo
Stat buffer
+ line="785">Stat buffer
Path in the archive
+ line="786">Path in the archive
User data
+ line="787">User data
-
+
List only loose (plain file) objects
+ line="1043">List only loose (plain file) objects
List only packed (compacted into blobs) objects
+ line="1044">List only packed (compacted into blobs) objects
List all objects
+ line="1045">List all objects
Only list objects in this repo, not parents
+ line="1046">Only list objects in this repo, not parents
-
+
No flags.
+ line="539">No flags.
Only list aliases. Since: 2017.10
+ line="540">Only list aliases. Since: 2017.10
Exclude remote refs. Since: 2017.11
+ line="541">Exclude remote refs. Since: 2017.11
Exclude mirrored refs. Since: 2019.2
+ line="542">Exclude mirrored refs. Since: 2019.2
Flags controlling repository locking.
-
+ line="1588">Flags controlling repository locking.
+
A "read only" lock; multiple readers are allowed.
+ line="1590">A "read only" lock; multiple readers are allowed.
A writable lock at most one writer can be active, and zero readers.
+ line="1591">A writable lock at most one writer can be active, and zero readers.
See the documentation of #OstreeRepo for more information about the
+ line="189">See the documentation of #OstreeRepo for more information about the
possible modes.
-
+
Files are stored as themselves; checkouts are hardlinks; can only be written as root
+ line="191">Files are stored as themselves; checkouts are hardlinks; can only be written as root
Files are compressed, should be owned by non-root. Can be served via HTTP. Since: 2017.12
+ line="192">Files are compressed, should be owned by non-root. Can be served via HTTP. Since: 2017.12
Legacy alias for `OSTREE_REPO_MODE_ARCHIVE`
+ line="193">Legacy alias for `OSTREE_REPO_MODE_ARCHIVE`
Files are stored as themselves, except ownership; can be written by user. Hardlinks work only in user checkouts.
+ line="194">Files are stored as themselves, except ownership; can be written by user. Hardlinks work only in user checkouts.
Same as BARE_USER, but all metadata is not stored, so it can only be used for user checkouts. Does not need xattrs.
+ line="195">Same as BARE_USER, but all metadata is not stored, so it can only be used for user checkouts. Does not need xattrs.
+
+
+ Same as BARE_USER, but xattrs are stored separately from file content, with dedicated object types.
-
+
No special options for pruning
+ line="1262">No special options for pruning
Don't actually delete objects
+ line="1263">Don't actually delete objects
Do not traverse individual commit objects, only follow refs
+ line="1264">Do not traverse individual commit objects, only follow refs
+
+
+ Only traverse commit objects. (Since 2022.2)
-
+
@@ -14239,105 +14362,105 @@ possible modes.
-
+
No special options for pull
+ line="1323">No special options for pull
Write out refs suitable for mirrors and fetch all refs if none requested
+ line="1324">Write out refs suitable for mirrors and fetch all refs if none requested
Fetch only the commit metadata
+ line="1325">Fetch only the commit metadata
Do verify checksums of local (filesystem-accessible) repositories (defaults on for HTTP)
+ line="1326">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="1327">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="1328">Don't verify checksums of objects HTTP repositories (Since: 2017.12)
The remote change operation.
-
+ line="164">The remote change operation.
+
Add a remote
+ line="167">Add a remote
Like above, but do nothing if the remote exists
+ line="168">Like above, but do nothing if the remote exists
Delete a remote
+ line="169">Delete a remote
Delete a remote, do nothing if the remote does not exist
+ line="170">Delete a remote, do nothing if the remote does not exist
Add or replace a remote (Since: 2019.2)
+ line="171">Add or replace a remote (Since: 2019.2)
-
+
No flags.
+ line="505">No flags.
Exclude remote and mirrored refs. Since: 2019.2
+ line="506">Exclude remote and mirrored refs. Since: 2019.2
c:symbol-prefix="repo_transaction_stats">
A list of statistics for each transaction that may be
+ line="270">A list of statistics for each transaction that may be
interesting for reporting purposes.
-
+
The total number of metadata objects
+ line="272">The total number of metadata objects
in the repository after this transaction has completed.
The number of metadata objects that
+ line="274">The number of metadata objects that
were written to the repository in this transaction.
The total number of content objects
+ line="276">The total number of content objects
in the repository after this transaction has completed.
The number of content objects that
+ line="278">The number of content objects that
were written to the repository in this transaction.
The amount of data added to the repository,
+ line="280">The amount of data added to the repository,
in bytes, counting only content objects.
@@ -14391,56 +14514,56 @@ in bytes, counting only content objects.
reserved
+ line="282">reserved
reserved
+ line="283">reserved
reserved
+ line="284">reserved
reserved
+ line="285">reserved
-
+
No flags
+ line="1560">No flags
Skip GPG verification
+ line="1561">Skip GPG verification
Skip all other signature verification methods
+ line="1562">Skip all other signature verification methods
-
+
@@ -14474,7 +14597,7 @@ in bytes, counting only content objects.
-
+
@@ -14485,8 +14608,8 @@ in bytes, counting only content objects.
c:type="OSTREE_SHA256_DIGEST_LEN">
Length of a sha256 digest when expressed as raw bytes
-
+ line="47">Length of a sha256 digest when expressed as raw bytes
+
c:type="OSTREE_SHA256_STRING_LEN">
Length of a sha256 digest when expressed as a hexadecimal string
-
+ line="54">Length of a sha256 digest when expressed as a hexadecimal string
+
version="2020.4">
The name of the default ed25519 signing type.
-
+ line="50">The name of the default ed25519 signing type.
+
-
+
-
+
-
+
@@ -14532,7 +14655,7 @@ in bytes, counting only content objects.
-
+
@@ -14546,18 +14669,18 @@ in bytes, counting only content objects.
glib:get-type="ostree_sepolicy_get_type">
-
+
An accessor object for SELinux policy in root located at @path
+ line="469">An accessor object for SELinux policy in root located at @path
Path to a root directory
+ line="465">Path to a root directory
allow-none="1">
Cancellable
+ line="466">Cancellable
@@ -14575,18 +14698,18 @@ in bytes, counting only content objects.
c:identifier="ostree_sepolicy_new_at"
version="2017.4"
throws="1">
-
+
An accessor object for SELinux policy in root located at @rootfs_dfd
+ line="485">An accessor object for SELinux policy in root located at @rootfs_dfd
Directory fd for rootfs (will not be cloned)
+ line="481">Directory fd for rootfs (will not be cloned)
allow-none="1">
Cancellable
+ line="482">Cancellable
@@ -14605,28 +14728,28 @@ in bytes, counting only content objects.
throws="1">
Extract the SELinux policy from a commit object via a partial checkout. This is useful
+ line="271">Extract the SELinux policy from a commit object via a partial checkout. This is useful
for labeling derived content as separate commits.
This function is the backend of `ostree_repo_commit_modifier_set_sepolicy_from_commit()`.
-
+
A new policy
+ line="283">A new policy
The repo
+ line="273">The repo
ostree ref or checksum
+ line="274">ostree ref or checksum
Cancellable
+ line="275">Cancellable
@@ -14644,8 +14767,8 @@ This function is the backend of `ostree_repo_commit_modifier_set_sepolicy_from_c
c:identifier="ostree_sepolicy_fscreatecon_cleanup">
Cleanup function for ostree_sepolicy_setfscreatecon().
-
+ line="710">Cleanup function for ostree_sepolicy_setfscreatecon().
+
@@ -14656,7 +14779,7 @@ This function is the backend of `ostree_repo_commit_modifier_set_sepolicy_from_c
allow-none="1">
Not used, just in case you didn't infer that from the parameter name
+ line="712">Not used, just in case you didn't infer that from the parameter name
@@ -14664,11 +14787,11 @@ This function is the backend of `ostree_repo_commit_modifier_set_sepolicy_from_c
-
+
Checksum of current policy
+ line="533">Checksum of current policy
@@ -14682,10 +14805,10 @@ This function is the backend of `ostree_repo_commit_modifier_set_sepolicy_from_c
throws="1">
Store in @out_label the security context for the given @relpath and
+ line="547">Store in @out_label the security context for the given @relpath and
mode @unix_mode. If the policy does not specify a label, %NULL
will be returned.
-
+
@@ -14693,19 +14816,19 @@ will be returned.
Self
+ line="549">Self
Path
+ line="550">Path
Unix mode
+ line="551">Unix mode
allow-none="1">
Return location for security context
+ line="552">Return location for security context
allow-none="1">
Cancellable
+ line="553">Cancellable
-
+
Type of current policy
+ line="517">Type of current policy
@@ -14747,21 +14870,21 @@ will be returned.
This API should be considered deprecated, because it's supported for
+ line="497">This API should be considered deprecated, because it's supported for
policy objects to be created from file-descriptor relative paths, which
may not be globally accessible.
-
+
Path to rootfs
+ line="505">Path to rootfs
A SePolicy object
+ line="499">A SePolicy object
@@ -14771,8 +14894,8 @@ may not be globally accessible.
throws="1">
Reset the security context of @target based on the SELinux policy.
-
+ line="599">Reset the security context of @target based on the SELinux policy.
+
@@ -14780,13 +14903,13 @@ may not be globally accessible.
Self
+ line="601">Self
Path string to use for policy lookup
+ line="602">Path string to use for policy lookup
allow-none="1">
File attributes
+ line="603">File attributes
Physical path to target file
+ line="604">Physical path to target file
Flags controlling behavior
+ line="605">Flags controlling behavior
@@ -14819,7 +14942,7 @@ may not be globally accessible.
allow-none="1">
New label, or %NULL if unchanged
+ line="606">New label, or %NULL if unchanged
allow-none="1">
Cancellable
+ line="607">Cancellable
@@ -14836,7 +14959,7 @@ may not be globally accessible.
-
+
@@ -14844,19 +14967,19 @@ may not be globally accessible.
Policy
+ line="676">Policy
Use this path to determine a label
+ line="677">Use this path to determine a label
Used along with @path
+ line="678">Used along with @path
@@ -14876,7 +14999,7 @@ may not be globally accessible.
-
+
@@ -14896,19 +15019,19 @@ may not be globally accessible.
glib:type-name="OstreeSign"
glib:get-type="ostree_sign_get_type"
glib:type-struct="SignInterface">
-
+
Return an array with newly allocated instances of all available
+ line="518">Return an array with newly allocated instances of all available
signing engines; they will not be initialized.
-
+
an array of signing engines
+ line="524">an array of signing engines
@@ -14920,19 +15043,19 @@ signing engines; they will not be initialized.
throws="1">
Create a new instance of a signing engine.
-
+ line="542">Create a new instance of a signing engine.
+
New signing engine, or %NULL if the engine is not known
+ line="549">New signing engine, or %NULL if the engine is not known
the name of desired signature engine
+ line="544">the name of desired signature engine
@@ -14943,15 +15066,15 @@ signing engines; they will not be initialized.
throws="1">
Add the public key for verification. Could be called multiple times for
+ line="201">Add the public key for verification. Could be called multiple times for
adding all needed keys to be used for verification.
The @public_key argument depends of the particular engine implementation.
-
+
@TRUE in case if the key could be added successfully,
+ line="212">@TRUE in case if the key could be added successfully,
@FALSE in case of error (@error will contain the reason).
@@ -14959,13 +15082,13 @@ The @public_key argument depends of the particular engine implementation.
an #OstreeSign object
+ line="203">an #OstreeSign object
single public key to be added
+ line="204">single public key to be added
@@ -14976,19 +15099,19 @@ The @public_key argument depends of the particular engine implementation.
throws="1">
Clear all previously preloaded secret and public keys.
-
+ line="124">Clear all previously preloaded secret and public keys.
+
@TRUE in case if no errors, @FALSE in case of error
+ line="131">@TRUE in case if no errors, @FALSE in case of error
an #OstreeSign object
+ line="126">an #OstreeSign object
@@ -14996,15 +15119,15 @@ The @public_key argument depends of the particular engine implementation.
Sign the given @data with pre-loaded secret key.
+ line="268">Sign the given @data with pre-loaded secret key.
Depending of the signing engine used you will need to load
the secret key with #ostree_sign_set_sk.
-
+
@TRUE if @data has been signed successfully,
+ line="281">@TRUE if @data has been signed successfully,
@FALSE in case of error (@error will contain the reason).
@@ -15012,13 +15135,13 @@ the secret key with #ostree_sign_set_sk.
an #OstreeSign object
+ line="270">an #OstreeSign object
the raw data to be signed with pre-loaded secret key
+ line="271">the raw data to be signed with pre-loaded secret key
transfer-ownership="full">
in case of success will contain signature
+ line="272">in case of success will contain signature
allow-none="1">
A #GCancellable
+ line="273">A #GCancellable
@@ -15047,16 +15170,16 @@ the secret key with #ostree_sign_set_sk.
throws="1">
Verify given data against signatures with pre-loaded public keys.
+ line="301">Verify given data against signatures with pre-loaded public keys.
Depending of the signing engine used you will need to load
the public key(s) with #ostree_sign_set_pk, #ostree_sign_add_pk
or #ostree_sign_load_pk.
-
+
@TRUE if @data has been signed at least with any single valid key,
+ line="315">@TRUE if @data has been signed at least with any single valid key,
@FALSE in case of error or no valid keys are available (@error will contain the reason).
@@ -15064,19 +15187,19 @@ or #ostree_sign_load_pk.
an #OstreeSign object
+ line="303">an #OstreeSign object
the raw data to check
+ line="304">the raw data to check
the signatures to be checked
+ line="305">the signatures to be checked
allow-none="1">
success message returned by the signing engine
+ line="306">success message returned by the signing engine
@@ -15096,12 +15219,12 @@ or #ostree_sign_load_pk.
Return the pointer to the name of currently used/selected signing engine.
-
+ line="436">Return the pointer to the name of currently used/selected signing engine.
+
pointer to the name
+ line="442">pointer to the name
@NULL in case of error (unlikely).
@@ -15109,7 +15232,7 @@ or #ostree_sign_load_pk.
an #OstreeSign object
+ line="438">an #OstreeSign object
@@ -15120,7 +15243,7 @@ or #ostree_sign_load_pk.
throws="1">
Load public keys for verification from anywhere.
+ line="229">Load public keys for verification from anywhere.
It is expected that all keys would be added to already pre-loaded keys.
The @options argument depends of the particular engine implementation.
@@ -15131,11 +15254,11 @@ For example, @ed25515 engine could use following string-formatted options:
'trusted.ed25519.d' and 'revoked.ed25519.d' with appropriate
public keys. Used for testing and re-definition of system-wide
directories if defaults are not suitable for any reason.
-
+
@TRUE in case if at least one key could be load successfully,
+ line="247">@TRUE in case if at least one key could be load successfully,
@FALSE in case of error (@error will contain the reason).
@@ -15143,13 +15266,13 @@ For example, @ed25515 engine could use following string-formatted options:
an #OstreeSign object
+ line="231">an #OstreeSign object
any options
+ line="232">any options
@@ -15159,13 +15282,13 @@ For example, @ed25515 engine could use following string-formatted options:
version="2020.2">
Return the pointer to the string with format used in (detached) metadata for
+ line="104">Return the pointer to the string with format used in (detached) metadata for
current signing engine.
-
+
pointer to the metadata format,
+ line="111">pointer to the metadata format,
@NULL in case of error (unlikely).
@@ -15173,7 +15296,7 @@ current signing engine.
an #OstreeSign object
+ line="106">an #OstreeSign object
@@ -15183,13 +15306,13 @@ current signing engine.
version="2020.2">
Return the pointer to the name of the key used in (detached) metadata for
+ line="84">Return the pointer to the name of the key used in (detached) metadata for
current signing engine.
-
+
pointer to the metadata key name,
+ line="91">pointer to the metadata key name,
@NULL in case of error (unlikely).
@@ -15197,7 +15320,7 @@ current signing engine.
an #OstreeSign object
+ line="86">an #OstreeSign object
@@ -15208,15 +15331,15 @@ current signing engine.
throws="1">
Set the public key for verification. It is expected what all
+ line="173">Set the public key for verification. It is expected what all
previously pre-loaded public keys will be dropped.
The @public_key argument depends of the particular engine implementation.
-
+
@TRUE in case if the key could be set successfully,
+ line="184">@TRUE in case if the key could be set successfully,
@FALSE in case of error (@error will contain the reason).
@@ -15224,13 +15347,13 @@ The @public_key argument depends of the particular engine implementation.
an #OstreeSign object
+ line="175">an #OstreeSign object
single public key to be added
+ line="176">single public key to be added
@@ -15241,14 +15364,14 @@ The @public_key argument depends of the particular engine implementation.
throws="1">
Set the secret key to be used for signing data, commits and summary.
+ line="146">Set the secret key to be used for signing data, commits and summary.
The @secret_key argument depends of the particular engine implementation.
-
+
@TRUE in case if the key could be set successfully,
+ line="156">@TRUE in case if the key could be set successfully,
@FALSE in case of error (@error will contain the reason).
@@ -15256,13 +15379,13 @@ The @secret_key argument depends of the particular engine implementation.
an #OstreeSign object
+ line="148">an #OstreeSign object
secret key to be added
+ line="149">secret key to be added
@@ -15273,15 +15396,15 @@ The @secret_key argument depends of the particular engine implementation.
throws="1">
Add the public key for verification. Could be called multiple times for
+ line="201">Add the public key for verification. Could be called multiple times for
adding all needed keys to be used for verification.
The @public_key argument depends of the particular engine implementation.
-
+
@TRUE in case if the key could be added successfully,
+ line="212">@TRUE in case if the key could be added successfully,
@FALSE in case of error (@error will contain the reason).
@@ -15289,13 +15412,13 @@ The @public_key argument depends of the particular engine implementation.
an #OstreeSign object
+ line="203">an #OstreeSign object
single public key to be added
+ line="204">single public key to be added
@@ -15306,19 +15429,19 @@ The @public_key argument depends of the particular engine implementation.
throws="1">
Clear all previously preloaded secret and public keys.
-
+ line="124">Clear all previously preloaded secret and public keys.
+
@TRUE in case if no errors, @FALSE in case of error
+ line="131">@TRUE in case if no errors, @FALSE in case of error
an #OstreeSign object
+ line="126">an #OstreeSign object
@@ -15329,15 +15452,15 @@ The @public_key argument depends of the particular engine implementation.
throws="1">
Add a signature to a commit.
+ line="456">Add a signature to a commit.
Depending of the signing engine used you will need to load
the secret key with #ostree_sign_set_sk.
-
+
@TRUE if commit has been signed successfully,
+ line="469">@TRUE if commit has been signed successfully,
@FALSE in case of error (@error will contain the reason).
@@ -15345,19 +15468,19 @@ the secret key with #ostree_sign_set_sk.
an #OstreeSign object
+ line="458">an #OstreeSign object
an #OsreeRepo object
+ line="459">an #OsreeRepo object
SHA256 of given commit to sign
+ line="460">SHA256 of given commit to sign
allow-none="1">
A #GCancellable
+ line="461">A #GCancellable
@@ -15377,16 +15500,16 @@ the secret key with #ostree_sign_set_sk.
throws="1">
Verify if commit is signed with known key.
+ line="369">Verify if commit is signed with known key.
Depending of the signing engine used you will need to load
the public key(s) for verification with #ostree_sign_set_pk,
#ostree_sign_add_pk and/or #ostree_sign_load_pk.
-
+
@TRUE if commit has been verified successfully,
+ line="384">@TRUE if commit has been verified successfully,
@FALSE in case of error or no valid keys are available (@error will contain the reason).
@@ -15394,19 +15517,19 @@ the public key(s) for verification with #ostree_sign_set_pk,
an #OstreeSign object
+ line="371">an #OstreeSign object
an #OsreeRepo object
+ line="372">an #OsreeRepo object
SHA256 of given commit to verify
+ line="373">SHA256 of given commit to verify
success message returned by the signing engine
+ line="374">success message returned by the signing engine
A #GCancellable
+ line="375">A #GCancellable
@@ -15438,15 +15561,15 @@ the public key(s) for verification with #ostree_sign_set_pk,
throws="1">
Sign the given @data with pre-loaded secret key.
+ line="268">Sign the given @data with pre-loaded secret key.
Depending of the signing engine used you will need to load
the secret key with #ostree_sign_set_sk.
-
+
@TRUE if @data has been signed successfully,
+ line="281">@TRUE if @data has been signed successfully,
@FALSE in case of error (@error will contain the reason).
@@ -15454,13 +15577,13 @@ the secret key with #ostree_sign_set_sk.
an #OstreeSign object
+ line="270">an #OstreeSign object
the raw data to be signed with pre-loaded secret key
+ line="271">the raw data to be signed with pre-loaded secret key
transfer-ownership="full">
in case of success will contain signature
+ line="272">in case of success will contain signature
allow-none="1">
A #GCancellable
+ line="273">A #GCancellable
@@ -15489,16 +15612,16 @@ the secret key with #ostree_sign_set_sk.
throws="1">
Verify given data against signatures with pre-loaded public keys.
+ line="301">Verify given data against signatures with pre-loaded public keys.
Depending of the signing engine used you will need to load
the public key(s) with #ostree_sign_set_pk, #ostree_sign_add_pk
or #ostree_sign_load_pk.
-
+
@TRUE if @data has been signed at least with any single valid key,
+ line="315">@TRUE if @data has been signed at least with any single valid key,
@FALSE in case of error or no valid keys are available (@error will contain the reason).
@@ -15506,19 +15629,19 @@ or #ostree_sign_load_pk.
an #OstreeSign object
+ line="303">an #OstreeSign object
the raw data to check
+ line="304">the raw data to check
the signatures to be checked
+ line="305">the signatures to be checked
allow-none="1">
success message returned by the signing engine
+ line="306">success message returned by the signing engine
@@ -15538,7 +15661,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15554,7 +15677,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15579,7 +15702,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15599,7 +15722,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15611,7 +15734,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15623,7 +15746,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15636,7 +15759,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15652,7 +15775,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15668,7 +15791,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15684,7 +15807,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15697,7 +15820,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15722,7 +15845,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15743,7 +15866,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15756,7 +15879,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15771,7 +15894,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15783,7 +15906,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15796,7 +15919,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15812,7 +15935,7 @@ or #ostree_sign_load_pk.
-
+
@@ -15830,12 +15953,12 @@ or #ostree_sign_load_pk.
version="2020.2">
Return the pointer to the name of currently used/selected signing engine.
-
+ line="436">Return the pointer to the name of currently used/selected signing engine.
+
pointer to the name
+ line="442">pointer to the name
@NULL in case of error (unlikely).
@@ -15843,7 +15966,7 @@ or #ostree_sign_load_pk.
an #OstreeSign object
+ line="438">an #OstreeSign object
@@ -15854,7 +15977,7 @@ or #ostree_sign_load_pk.
throws="1">
Load public keys for verification from anywhere.
+ line="229">Load public keys for verification from anywhere.
It is expected that all keys would be added to already pre-loaded keys.
The @options argument depends of the particular engine implementation.
@@ -15865,11 +15988,11 @@ For example, @ed25515 engine could use following string-formatted options:
'trusted.ed25519.d' and 'revoked.ed25519.d' with appropriate
public keys. Used for testing and re-definition of system-wide
directories if defaults are not suitable for any reason.
-
+
@TRUE in case if at least one key could be load successfully,
+ line="247">@TRUE in case if at least one key could be load successfully,
@FALSE in case of error (@error will contain the reason).
@@ -15877,13 +16000,13 @@ For example, @ed25515 engine could use following string-formatted options:
an #OstreeSign object
+ line="231">an #OstreeSign object
any options
+ line="232">any options
@@ -15893,13 +16016,13 @@ For example, @ed25515 engine could use following string-formatted options:
version="2020.2">
Return the pointer to the string with format used in (detached) metadata for
+ line="104">Return the pointer to the string with format used in (detached) metadata for
current signing engine.
-
+
pointer to the metadata format,
+ line="111">pointer to the metadata format,
@NULL in case of error (unlikely).
@@ -15907,7 +16030,7 @@ current signing engine.
an #OstreeSign object
+ line="106">an #OstreeSign object
@@ -15917,13 +16040,13 @@ current signing engine.
version="2020.2">
Return the pointer to the name of the key used in (detached) metadata for
+ line="84">Return the pointer to the name of the key used in (detached) metadata for
current signing engine.
-
+
pointer to the metadata key name,
+ line="91">pointer to the metadata key name,
@NULL in case of error (unlikely).
@@ -15931,7 +16054,7 @@ current signing engine.
an #OstreeSign object
+ line="86">an #OstreeSign object
@@ -15942,15 +16065,15 @@ current signing engine.
throws="1">
Set the public key for verification. It is expected what all
+ line="173">Set the public key for verification. It is expected what all
previously pre-loaded public keys will be dropped.
The @public_key argument depends of the particular engine implementation.
-
+
@TRUE in case if the key could be set successfully,
+ line="184">@TRUE in case if the key could be set successfully,
@FALSE in case of error (@error will contain the reason).
@@ -15958,13 +16081,13 @@ The @public_key argument depends of the particular engine implementation.
an #OstreeSign object
+ line="175">an #OstreeSign object
single public key to be added
+ line="176">single public key to be added
@@ -15975,14 +16098,14 @@ The @public_key argument depends of the particular engine implementation.
throws="1">
Set the secret key to be used for signing data, commits and summary.
+ line="146">Set the secret key to be used for signing data, commits and summary.
The @secret_key argument depends of the particular engine implementation.
-
+
@TRUE in case if the key could be set successfully,
+ line="156">@TRUE in case if the key could be set successfully,
@FALSE in case of error (@error will contain the reason).
@@ -15990,13 +16113,13 @@ The @secret_key argument depends of the particular engine implementation.
an #OstreeSign object
+ line="148">an #OstreeSign object
secret key to be added
+ line="149">secret key to be added
@@ -16007,32 +16130,32 @@ The @secret_key argument depends of the particular engine implementation.
throws="1">
Add a signature to a summary file.
+ line="584">Add a signature to a summary file.
Based on ostree_repo_add_gpg_signature_summary implementation.
-
+
@TRUE if summary file has been signed with all provided keys
+ line="595">@TRUE if summary file has been signed with all provided keys
Self
+ line="586">Self
ostree repository
+ line="587">ostree repository
keys -- GVariant containing keys as GVarints specific to signature type.
+ line="588">keys -- GVariant containing keys as GVarints specific to signature type.
allow-none="1">
A #GCancellable
+ line="589">A #GCancellable
-
+
-
+
-
+
-
+
@@ -16068,17 +16191,17 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
-
+
-
+
pointer to the name
+ line="442">pointer to the name
@NULL in case of error (unlikely).
@@ -16086,7 +16209,7 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
an #OstreeSign object
+ line="438">an #OstreeSign object
@@ -16094,11 +16217,11 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
-
+
@TRUE if @data has been signed successfully,
+ line="281">@TRUE if @data has been signed successfully,
@FALSE in case of error (@error will contain the reason).
@@ -16106,13 +16229,13 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
an #OstreeSign object
+ line="270">an #OstreeSign object
the raw data to be signed with pre-loaded secret key
+ line="271">the raw data to be signed with pre-loaded secret key
transfer-ownership="full">
in case of success will contain signature
+ line="272">in case of success will contain signature
allow-none="1">
A #GCancellable
+ line="273">A #GCancellable
@@ -16138,11 +16261,11 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
-
+
@TRUE if @data has been signed at least with any single valid key,
+ line="315">@TRUE if @data has been signed at least with any single valid key,
@FALSE in case of error or no valid keys are available (@error will contain the reason).
@@ -16150,19 +16273,19 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
an #OstreeSign object
+ line="303">an #OstreeSign object
the raw data to check
+ line="304">the raw data to check
the signatures to be checked
+ line="305">the signatures to be checked
allow-none="1">
success message returned by the signing engine
+ line="306">success message returned by the signing engine
@@ -16182,11 +16305,11 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
-
+
pointer to the metadata key name,
+ line="91">pointer to the metadata key name,
@NULL in case of error (unlikely).
@@ -16194,7 +16317,7 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
an #OstreeSign object
+ line="86">an #OstreeSign object
@@ -16202,11 +16325,11 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
-
+
pointer to the metadata format,
+ line="111">pointer to the metadata format,
@NULL in case of error (unlikely).
@@ -16214,7 +16337,7 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
an #OstreeSign object
+ line="106">an #OstreeSign object
@@ -16222,18 +16345,18 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
-
+
@TRUE in case if no errors, @FALSE in case of error
+ line="131">@TRUE in case if no errors, @FALSE in case of error
an #OstreeSign object
+ line="126">an #OstreeSign object
@@ -16241,11 +16364,11 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
-
+
@TRUE in case if the key could be set successfully,
+ line="156">@TRUE in case if the key could be set successfully,
@FALSE in case of error (@error will contain the reason).
@@ -16253,13 +16376,13 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
an #OstreeSign object
+ line="148">an #OstreeSign object
secret key to be added
+ line="149">secret key to be added
@@ -16267,11 +16390,11 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
-
+
@TRUE in case if the key could be set successfully,
+ line="184">@TRUE in case if the key could be set successfully,
@FALSE in case of error (@error will contain the reason).
@@ -16279,13 +16402,13 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
an #OstreeSign object
+ line="175">an #OstreeSign object
single public key to be added
+ line="176">single public key to be added
@@ -16293,11 +16416,11 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
-
+
@TRUE in case if the key could be added successfully,
+ line="212">@TRUE in case if the key could be added successfully,
@FALSE in case of error (@error will contain the reason).
@@ -16305,13 +16428,13 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
an #OstreeSign object
+ line="203">an #OstreeSign object
single public key to be added
+ line="204">single public key to be added
@@ -16319,11 +16442,11 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
-
+
@TRUE in case if at least one key could be load successfully,
+ line="247">@TRUE in case if at least one key could be load successfully,
@FALSE in case of error (@error will contain the reason).
@@ -16331,13 +16454,13 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
an #OstreeSign object
+ line="231">an #OstreeSign object
any options
+ line="232">any options
@@ -16348,35 +16471,35 @@ Based on ostree_repo_add_gpg_signature_summary implementation.
c:type="OstreeStaticDeltaGenerateOpt">
Parameters controlling optimization of static deltas.
-
+ line="1089">Parameters controlling optimization of static deltas.
+
Optimize for speed of delta creation over space
+ line="1091">Optimize for speed of delta creation over space
Optimize for delta size (may be very slow)
+ line="1092">Optimize for delta size (may be very slow)
Flags controlling static delta index generation.
-
+ line="1111">Flags controlling static delta index generation.
+
No special flags
+ line="1113">No special flags
Create a new #OstreeSysroot object for the sysroot at @path. If @path is %NULL,
+ line="206">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="215">An accessor object for an system root located at @path
@@ -16405,7 +16528,7 @@ ostree_sysroot_new_default().
allow-none="1">
Path to a system root directory, or %NULL to use the
+ line="208">Path to a system root directory, or %NULL to use the
current visible root file system
@@ -16413,28 +16536,28 @@ ostree_sysroot_new_default().
-
+
An accessor for the current visible root / filesystem
+ line="226">An accessor for the current visible root / filesystem
-
+
Path to deployment origin file
+ line="1348">Path to deployment origin file
A deployment path
+ line="1346">A deployment path
@@ -16442,9 +16565,9 @@ ostree_sysroot_new_default().
Delete any state that resulted from a partially completed
+ line="541">Delete any state that resulted from a partially completed
transaction, such as incomplete deployments.
-
+
@@ -16452,7 +16575,7 @@ transaction, such as incomplete deployments.
Sysroot
+ line="543">Sysroot
allow-none="1">
Cancellable
+ line="544">Cancellable
@@ -16472,7 +16595,7 @@ transaction, such as incomplete deployments.
throws="1">
Prune the system repository. This is a thin wrapper
+ line="465">Prune the system repository. This is a thin wrapper
around ostree_repo_prune_from_reachable(); the primary
addition is that this function automatically gathers
all deployed commits into the reachable set.
@@ -16481,7 +16604,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
-
+
@@ -16489,13 +16612,13 @@ Locking: exclusive
Sysroot
+ line="467">Sysroot
Flags controlling pruning
+ line="468">Flags controlling pruning
transfer-ownership="full">
Number of objects found
+ line="469">Number of objects found
transfer-ownership="full">
Number of objects deleted
+ line="470">Number of objects deleted
transfer-ownership="full">
Storage size in bytes of objects deleted
+ line="471">Storage size in bytes of objects deleted
allow-none="1">
Cancellable
+ line="472">Cancellable
@@ -16542,8 +16665,8 @@ Locking: exclusive
throws="1">
Older version of ostree_sysroot_stage_tree_with_options().
-
+ line="2960">Older version of ostree_sysroot_stage_tree_with_options().
+
@@ -16551,7 +16674,7 @@ Locking: exclusive
Sysroot
+ line="2962">Sysroot
allow-none="1">
osname to use for merge deployment
+ line="2963">osname to use for merge deployment
Checksum to add
+ line="2964">Checksum to add
allow-none="1">
Origin to use for upgrades
+ line="2965">Origin to use for upgrades
allow-none="1">
Use this deployment for merge path
+ line="2966">Use this deployment for merge path
allow-none="1">
Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment
+ line="2967">Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment
@@ -16604,7 +16727,7 @@ Locking: exclusive
transfer-ownership="full">
The new deployment path
+ line="2968">The new deployment path
allow-none="1">
Cancellable
+ line="2969">Cancellable
@@ -16624,12 +16747,12 @@ Locking: exclusive
throws="1">
Check out deployment tree with revision @revision, performing a 3
+ line="2913">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.
-
+
@@ -16637,7 +16760,7 @@ ostree_sysroot_stage_tree() API instead.
Sysroot
+ line="2915">Sysroot
allow-none="1">
osname to use for merge deployment
+ line="2916">osname to use for merge deployment
Checksum to add
+ line="2917">Checksum to add
allow-none="1">
Origin to use for upgrades
+ line="2918">Origin to use for upgrades
allow-none="1">
Use this deployment for merge path
+ line="2919">Use this deployment for merge path
allow-none="1">
Options
+ line="2920">Options
@@ -16689,7 +16812,7 @@ ostree_sysroot_stage_tree() API instead.
transfer-ownership="full">
The new deployment path
+ line="2921">The new deployment path
allow-none="1">
Cancellable
+ line="2922">Cancellable
@@ -16708,9 +16831,9 @@ ostree_sysroot_stage_tree() API instead.
throws="1">
Entirely replace the kernel arguments of @deployment with the
+ line="3361">Entirely replace the kernel arguments of @deployment with the
values in @new_kargs.
-
+
@@ -16718,19 +16841,19 @@ values in @new_kargs.
Sysroot
+ line="3363">Sysroot
A deployment
+ line="3364">A deployment
Replace deployment's kernel arguments
+ line="3365">Replace deployment's kernel arguments
@@ -16741,7 +16864,7 @@ values in @new_kargs.
allow-none="1">
Cancellable
+ line="3366">Cancellable
@@ -16751,10 +16874,10 @@ values in @new_kargs.
throws="1">
By default, deployment directories are not mutable. This function
+ line="3410">By default, deployment directories are not mutable. This function
will allow making them temporarily mutable, for example to allow
layering additional non-OSTree content.
-
+
@@ -16762,19 +16885,19 @@ layering additional non-OSTree content.
Sysroot
+ line="3412">Sysroot
A deployment
+ line="3413">A deployment
Whether or not deployment's files can be changed
+ line="3414">Whether or not deployment's files can be changed
allow-none="1">
Cancellable
+ line="3415">Cancellable
@@ -16794,7 +16917,7 @@ layering additional non-OSTree content.
throws="1">
By default, deployments may be subject to garbage collection. Typical uses of
+ line="2212">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
@@ -16803,7 +16926,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).
-
+
@@ -16811,19 +16934,19 @@ the staged deployment (as it's not in the bootloader entries).
Sysroot
+ line="2214">Sysroot
A deployment
+ line="2215">A deployment
Whether or not deployment will be automatically GC'd
+ line="2216">Whether or not deployment will be automatically GC'd
@@ -16834,13 +16957,13 @@ the staged deployment (as it's not in the bootloader entries).
throws="1">
Configure the target deployment @deployment such that it
+ line="2006">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.
-
+
@@ -16848,19 +16971,19 @@ across reboots.
Sysroot
+ line="2008">Sysroot
Deployment
+ line="2009">Deployment
Transition to this unlocked state
+ line="2010">Transition to this unlocked state
@@ -16870,7 +16993,7 @@ across reboots.
allow-none="1">
Cancellable
+ line="2011">Cancellable
@@ -16880,9 +17003,9 @@ across reboots.
throws="1">
Ensure that @self is set up as a valid rootfs, by creating
+ line="427">Ensure that @self is set up as a valid rootfs, by creating
/ostree/repo, among other things.
-
+
@@ -16890,7 +17013,7 @@ across reboots.
Sysroot
+ line="429">Sysroot
allow-none="1">
Cancellable
+ line="430">Cancellable
-
+ This function may only be called if the sysroot is loaded.
+
The currently booted deployment, or %NULL if none
+ line="1243">The currently booted deployment, or %NULL if none
Sysroot
+ line="1239">Sysroot
-
+
@@ -16936,24 +17062,24 @@ across reboots.
-
+
Path to deployment root directory
+ line="1334">Path to deployment root directory
Sysroot
+ line="1331">Sysroot
A deployment
+ line="1332">A deployment
@@ -16962,38 +17088,38 @@ across reboots.
c:identifier="ostree_sysroot_get_deployment_dirpath">
Note this function only returns a *relative* path - if you want
+ line="1308">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="1317">Path to deployment root directory, relative to sysroot
Repo
+ line="1310">Repo
A deployment
+ line="1311">A deployment
-
+
Ordered list of deployments
+ line="1295">Ordered list of deployments
@@ -17002,7 +17128,7 @@ or concatenate it with the full ostree_sysroot_get_path().
Sysroot
+ line="1293">Sysroot
@@ -17010,21 +17136,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="363">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="371">A file descriptor valid for the lifetime of @self
Sysroot
+ line="365">Sysroot
@@ -17033,20 +17159,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="1561">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="1569">Configuration merge deployment
Sysroot
+ line="1563">Sysroot
allow-none="1">
Operating system group
+ line="1564">Operating system group
-
+
Path to rootfs
+ line="265">Path to rootfs
Sysroot
+ line="263">Sysroot
@@ -17082,20 +17208,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="1359">Retrieve the OSTree repository in sysroot @self. The repo is guaranteed to be open
(see ostree_repo_open()).
-
+
%TRUE on success, %FALSE otherwise
+ line="1369">%TRUE on success, %FALSE otherwise
Sysroot
+ line="1361">Sysroot
allow-none="1">
Repository in sysroot @self
+ line="1362">Repository in sysroot @self
allow-none="1">
Cancellable
+ line="1363">Cancellable
@@ -17123,25 +17249,25 @@ the first one in the current deployment list which matches osname.
-
+
The currently staged deployment, or %NULL if none
+ line="1279">The currently staged deployment, or %NULL if none
Sysroot
+ line="1277">Sysroot
-
+
@@ -17157,10 +17283,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="1757">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.
-
+
@@ -17168,13 +17294,13 @@ is required for generating a deployment.
Sysroot
+ line="1759">Sysroot
Name group of operating system checkouts
+ line="1760">Name group of operating system checkouts
allow-none="1">
Cancellable
+ line="1761">Cancellable
@@ -17194,12 +17320,12 @@ is required for generating a deployment.
throws="1">
Subset of ostree_sysroot_load(); performs basic initialization. Notably, one
+ line="956">Subset of ostree_sysroot_load(); performs basic initialization. Notably, one
can invoke `ostree_sysroot_get_fd()` after calling this function.
It is not necessary to call this function if ostree_sysroot_load() is
invoked.
-
+
@@ -17207,7 +17333,7 @@ invoked.
sysroot
+ line="958">sysroot
@@ -17217,19 +17343,19 @@ invoked.
version="2020.1">
Can only be invoked after `ostree_sysroot_initialize()`.
-
+ line="380">Can only be invoked after `ostree_sysroot_initialize()`.
+
%TRUE iff the sysroot points to a booted deployment
+ line="386">%TRUE iff the sysroot points to a booted deployment
Sysroot
+ line="382">Sysroot
@@ -17237,9 +17363,9 @@ invoked.
Load deployment list, bootversion, and subbootversion from the
+ line="912">Load deployment list, bootversion, and subbootversion from the
rootfs @self.
-
+
@@ -17247,7 +17373,7 @@ rootfs @self.
Sysroot
+ line="914">Sysroot
allow-none="1">
Cancellable
+ line="915">Cancellable
@@ -17265,7 +17391,7 @@ rootfs @self.
c:identifier="ostree_sysroot_load_if_changed"
version="2016.4"
throws="1">
-
+
@@ -17273,7 +17399,7 @@ rootfs @self.
#OstreeSysroot
+ line="1171">#OstreeSysroot
allow-none="1">
Cancellable
+ line="1173">Cancellable
@@ -17296,13 +17422,13 @@ rootfs @self.
Acquire an exclusive multi-process write lock for @self. This call
+ line="1611">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.
-
+
@@ -17310,7 +17436,7 @@ be released if @self is deallocated.
Self
+ line="1613">Self
@@ -17318,8 +17444,8 @@ be released if @self is deallocated.
An asynchronous version of ostree_sysroot_lock().
-
+ line="1721">An asynchronous version of ostree_sysroot_lock().
+
@@ -17327,7 +17453,7 @@ be released if @self is deallocated.
Self
+ line="1723">Self
allow-none="1">
Cancellable
+ line="1724">Cancellable
closure="2">
Callback
+ line="1725">Callback
allow-none="1">
User data
+ line="1726">User data
@@ -17366,8 +17492,8 @@ be released if @self is deallocated.
throws="1">
Call when ostree_sysroot_lock_async() is ready.
-
+ line="1740">Call when ostree_sysroot_lock_async() is ready.
+
@@ -17375,37 +17501,37 @@ be released if @self is deallocated.
Self
+ line="1742">Self
Result
+ line="1743">Result
-
+
A new config file which sets @refspec as an origin
+ line="1600">A new config file which sets @refspec as an origin
Sysroot
+ line="1597">Sysroot
A refspec
+ line="1598">A refspec
@@ -17415,9 +17541,9 @@ be released if @self is deallocated.
throws="1">
Like ostree_sysroot_cleanup() in that it cleans up incomplete deployments
+ line="558">Like ostree_sysroot_cleanup() in that it cleans up incomplete deployments
and old boot versions, but does NOT prune the repository.
-
+
@@ -17425,7 +17551,7 @@ and old boot versions, but does NOT prune the repository.
Sysroot
+ line="560">Sysroot
allow-none="1">
Cancellable
+ line="561">Cancellable
@@ -17444,12 +17570,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="1504">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.
-
+
@@ -17457,7 +17583,7 @@ we're not looking at the booted deployment.
Sysroot
+ line="1506">Sysroot
allow-none="1">
"stateroot" name
+ line="1507">"stateroot" name
allow-none="1">
The pending deployment
+ line="1508">The pending deployment
allow-none="1">
The rollback deployment
+ line="1509">The rollback deployment
@@ -17498,21 +17624,21 @@ we're not looking at the booted deployment.
This function is a variant of ostree_sysroot_get_repo() that cannot fail, and
+ line="1384">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="1392">The OSTree repository in sysroot @self.
Sysroot
+ line="1386">Sysroot
@@ -17523,19 +17649,19 @@ or ostree_sysroot_load() has been invoked successfully.
throws="1">
Find the booted deployment, or return an error if not booted via OSTree.
-
+ line="1255">Find the booted deployment, or return an error if not booted via OSTree.
+
The currently booted deployment, or an error
+ line="1261">The currently booted deployment, or an error
Sysroot
+ line="1257">Sysroot
@@ -17545,7 +17671,7 @@ or ostree_sysroot_load() has been invoked successfully.
version="2020.1">
If this function is invoked, then libostree will assume that
+ line="234">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.
@@ -17557,7 +17683,7 @@ any mount points on which it operates. This currently is just `/sysroot` and
If you invoke this function, it must be before ostree_sysroot_load(); it may
be invoked before or after ostree_sysroot_initialize().
-
+
@@ -17572,7 +17698,7 @@ be invoked before or after ostree_sysroot_initialize().
throws="1">
Prepend @new_deployment to the list of deployments, commit, and
+ line="1821">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.
@@ -17594,7 +17720,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.
-
+
@@ -17602,7 +17728,7 @@ later, instead.
Sysroot
+ line="1823">Sysroot
allow-none="1">
OS name
+ line="1824">OS name
Prepend this deployment to the list
+ line="1825">Prepend this deployment to the list
allow-none="1">
Use this deployment for configuration merge
+ line="1826">Use this deployment for configuration merge
Flags controlling behavior
+ line="1827">Flags controlling behavior
@@ -17642,7 +17768,7 @@ later, instead.
allow-none="1">
Cancellable
+ line="1828">Cancellable
@@ -17653,10 +17779,10 @@ later, instead.
throws="1">
Stage an overlay initrd to be used in an upcoming deployment. Returns a checksum which
+ line="3052">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.
-
+
@@ -17664,13 +17790,13 @@ ostree_sysroot_stage_tree_with_options() via the `overlay_initrds` array option.
Sysroot
+ line="3054">Sysroot
File descriptor to overlay initrd
+ line="3055">File descriptor to overlay initrd
Overlay initrd checksum
+ line="3056">Overlay initrd checksum
Cancellable
+ line="3057">Cancellable
@@ -17699,8 +17825,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="3109">Older version of ostree_sysroot_stage_tree_with_options().
+
@@ -17708,7 +17834,7 @@ ostree_sysroot_stage_tree_with_options() via the `overlay_initrds` array option.
Sysroot
+ line="3111">Sysroot
osname to use for merge deployment
+ line="3112">osname to use for merge deployment
Checksum to add
+ line="3113">Checksum to add
Origin to use for upgrades
+ line="3114">Origin to use for upgrades
Use this deployment for merge path
+ line="3115">Use this deployment for merge path
Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment
+ line="3116">Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment
@@ -17761,7 +17887,7 @@ ostree_sysroot_stage_tree_with_options() via the `overlay_initrds` array option.
transfer-ownership="full">
The new deployment path
+ line="3117">The new deployment path
Cancellable
+ line="3118">Cancellable
@@ -17781,9 +17907,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="3143">Like ostree_sysroot_deploy_tree(), but "finalization" only occurs at OS
shutdown time.
-
+
@@ -17791,7 +17917,7 @@ shutdown time.
Sysroot
+ line="3145">Sysroot
allow-none="1">
osname to use for merge deployment
+ line="3146">osname to use for merge deployment
Checksum to add
+ line="3147">Checksum to add
allow-none="1">
Origin to use for upgrades
+ line="3148">Origin to use for upgrades
allow-none="1">
Use this deployment for merge path
+ line="3149">Use this deployment for merge path
Options
+ line="3150">Options
@@ -17840,7 +17966,7 @@ shutdown time.
transfer-ownership="full">
The new deployment path
+ line="3151">The new deployment path
allow-none="1">
Cancellable
+ line="3152">Cancellable
@@ -17859,14 +17985,14 @@ shutdown time.
throws="1">
Try to acquire an exclusive multi-process write lock for @self. If
+ line="1637">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.
-
+
@@ -17874,7 +18000,7 @@ be released if @self is deallocated.
Self
+ line="1639">Self
transfer-ownership="full">
Whether or not the lock has been acquired
+ line="1640">Whether or not the lock has been acquired
@@ -17891,13 +18017,13 @@ be released if @self is deallocated.
Release any resources such as file descriptors referring to the
+ line="409">Release any resources such as file descriptors referring to the
root directory of this sysroot. Normally, those resources are
cleared by finalization, but in garbage collected languages that
may not be predictable.
This undoes the effect of `ostree_sysroot_load()`.
-
+
@@ -17905,7 +18031,7 @@ This undoes the effect of `ostree_sysroot_load()`.
Sysroot
+ line="411">Sysroot
@@ -17913,10 +18039,10 @@ This undoes the effect of `ostree_sysroot_load()`.
Clear the lock previously acquired with ostree_sysroot_lock(). It
+ line="1685">Clear the lock previously acquired with ostree_sysroot_lock(). It
is safe to call this function if the lock has not been previously
acquired.
-
+
@@ -17924,7 +18050,7 @@ acquired.
Self
+ line="1687">Self
@@ -17934,9 +18060,9 @@ acquired.
throws="1">
Older version of ostree_sysroot_write_deployments_with_options(). This
+ line="2292">Older version of ostree_sysroot_write_deployments_with_options(). This
version will perform post-deployment cleanup by default.
-
+
@@ -17944,13 +18070,13 @@ version will perform post-deployment cleanup by default.
Sysroot
+ line="2294">Sysroot
List of new deployments
+ line="2295">List of new deployments
@@ -17961,7 +18087,7 @@ version will perform post-deployment cleanup by default.
allow-none="1">
Cancellable
+ line="2296">Cancellable
@@ -17972,13 +18098,13 @@ version will perform post-deployment cleanup by default.
throws="1">
Assuming @new_deployments have already been deployed in place on disk via
+ line="2422">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.
-
+
@@ -17986,13 +18112,13 @@ if for example you want to control pruning of the repository.
Sysroot
+ line="2424">Sysroot
List of new deployments
+ line="2425">List of new deployments
@@ -18000,7 +18126,7 @@ if for example you want to control pruning of the repository.
Options
+ line="2426">Options
@@ -18010,7 +18136,7 @@ if for example you want to control pruning of the repository.
allow-none="1">
Cancellable
+ line="2427">Cancellable
@@ -18020,10 +18146,10 @@ if for example you want to control pruning of the repository.
throws="1">
Immediately replace the origin file of the referenced @deployment
+ line="950">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.
-
+
@@ -18031,13 +18157,13 @@ this function will write the current origin of @deployment.
System root
+ line="952">System root
Deployment
+ line="953">Deployment
allow-none="1">
Origin content
+ line="954">Origin content
allow-none="1">
Cancellable
+ line="955">Cancellable
@@ -18069,7 +18195,7 @@ this function will write the current origin of @deployment.
libostree will log to the journal various events, such as the /etc merge
+ line="162">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.
@@ -18082,14 +18208,14 @@ Currently, the structured data is only available via the systemd journal.
Human-readable string (should not contain newlines)
+ line="165">Human-readable string (should not contain newlines)
-
+
@@ -18114,7 +18240,7 @@ Currently, the structured data is only available via the systemd journal.
-
+
@@ -18150,18 +18276,18 @@ Currently, the structured data is only available via the systemd journal.
-
+
An upgrader
+ line="271">An upgrader
An #OstreeSysroot
+ line="267">An #OstreeSysroot
allow-none="1">
Cancellable
+ line="268">Cancellable
@@ -18178,18 +18304,18 @@ Currently, the structured data is only available via the systemd journal.
-
+
An upgrader
+ line="289">An upgrader
An #OstreeSysroot
+ line="284">An #OstreeSysroot
allow-none="1">
Operating system name
+ line="285">Operating system name
allow-none="1">
Cancellable
+ line="286">Cancellable
@@ -18215,18 +18341,18 @@ Currently, the structured data is only available via the systemd journal.
-
+
An upgrader
+ line="309">An upgrader
An #OstreeSysroot
+ line="303">An #OstreeSysroot
allow-none="1">
Operating system name
+ line="304">Operating system name
Flags
+ line="305">Flags
@@ -18251,7 +18377,7 @@ Currently, the structured data is only available via the systemd journal.
allow-none="1">
Cancellable
+ line="306">Cancellable
@@ -18261,10 +18387,10 @@ Currently, the structured data is only available via the systemd journal.
throws="1">
Check that the timestamp on @to_rev is equal to or newer than
+ line="401">Check that the timestamp on @to_rev is equal to or newer than
@from_rev. This protects systems against man-in-the-middle
attackers which provide a client with an older commit.
-
+
@@ -18272,19 +18398,19 @@ attackers which provide a client with an older commit.
Repo
+ line="403">Repo
From revision
+ line="404">From revision
To revision
+ line="405">To revision
@@ -18294,9 +18420,9 @@ attackers which provide a client with an older commit.
throws="1">
Write the new deployment to disk, perform a configuration merge
+ line="630">Write the new deployment to disk, perform a configuration merge
with /etc, and update the bootloader configuration.
-
+
@@ -18304,7 +18430,7 @@ with /etc, and update the bootloader configuration.
Self
+ line="632">Self
allow-none="1">
Cancellable
+ line="633">Cancellable
-
+
A copy of the origin file, or %NULL if unknown
+ line="338">A copy of the origin file, or %NULL if unknown
Sysroot
+ line="336">Sysroot
-
+
The origin file, or %NULL if unknown
+ line="326">The origin file, or %NULL if unknown
Sysroot
+ line="324">Sysroot
-
+
A one-line descriptive summary of the origin, or %NULL if unknown
+ line="391">A one-line descriptive summary of the origin, or %NULL if unknown
Upgrader
+ line="389">Upgrader
@@ -18377,13 +18503,13 @@ with /etc, and update the bootloader configuration.
throws="1">
Perform a pull from the origin. First check if the ref has
+ line="440">Perform a pull from the origin. First check if the ref has
changed, if so download the linked objects, and store the updated
ref locally. Then @out_changed will be %TRUE.
If the origin remote is unchanged, @out_changed will be set to
%FALSE.
-
+
@@ -18391,19 +18517,19 @@ If the origin remote is unchanged, @out_changed will be set to
Upgrader
+ line="442">Upgrader
Flags controlling pull behavior
+ line="443">Flags controlling pull behavior
Flags controlling upgrader behavior
+ line="444">Flags controlling upgrader behavior
@@ -18413,7 +18539,7 @@ If the origin remote is unchanged, @out_changed will be set to
allow-none="1">
Progress
+ line="445">Progress
Whether or not the origin changed
+ line="446">Whether or not the origin changed
Cancellable
+ line="447">Cancellable
@@ -18441,10 +18567,10 @@ If the origin remote is unchanged, @out_changed will be set to
throws="1">
Like ostree_sysroot_upgrader_pull(), but allows retrieving just a
+ line="469">Like ostree_sysroot_upgrader_pull(), but allows retrieving just a
subpath of the tree. This can be used to download metadata files
from inside the tree such as package databases.
-
+
@@ -18452,25 +18578,25 @@ from inside the tree such as package databases.
Upgrader
+ line="471">Upgrader
Subdirectory path (should include a leading /)
+ line="472">Subdirectory path (should include a leading /)
Flags controlling pull behavior
+ line="473">Flags controlling pull behavior
Flags controlling upgrader behavior
+ line="474">Flags controlling upgrader behavior
@@ -18480,7 +18606,7 @@ from inside the tree such as package databases.
allow-none="1">
Progress
+ line="475">Progress
transfer-ownership="full">
Whether or not the origin changed
+ line="476">Whether or not the origin changed
allow-none="1">
Cancellable
+ line="477">Cancellable
@@ -18508,8 +18634,8 @@ from inside the tree such as package databases.
throws="1">
Replace the origin with @origin.
-
+ line="361">Replace the origin with @origin.
+
@@ -18517,7 +18643,7 @@ from inside the tree such as package databases.
Sysroot
+ line="363">Sysroot
allow-none="1">
The new origin
+ line="364">The new origin
allow-none="1">
Cancellable
+ line="365">Cancellable
@@ -18565,14 +18691,14 @@ from inside the tree such as package databases.
c:type="OstreeSysrootUpgraderFlags">
Flags controlling operation of an #OstreeSysrootUpgrader.
+ line="32">Flags controlling operation of an #OstreeSysrootUpgrader.
Do not error if the origin has an unconfigured-state key
+ line="35">Do not error if the origin has an unconfigured-state key
glib:nick="stage">
Enable "staging" (finalization at shutdown); recommended
+ line="36">Enable "staging" (finalization at shutdown); recommended
(Since: 2021.4)
-
+
@@ -18602,7 +18728,7 @@ from inside the tree such as package databases.
-
+
@@ -18625,53 +18751,53 @@ from inside the tree such as package databases.
The mtime used for stored files. This was originally 0, changed to 1 for
+ line="180">The mtime used for stored files. This was originally 0, changed to 1 for
a few releases, then was reverted due to regressions it introduced from
users who had been using zero before.
-
+
-
+
ostree version.
-
+ line="46">ostree version.
+
ostree version, encoded as a string, useful for printing and
+ line="55">ostree version, encoded as a string, useful for printing and
concatenation.
-
+
ostree year version component (e.g. 2017 if %OSTREE_VERSION is 2017.2)
-
+ line="28">ostree year version component (e.g. 2017 if %OSTREE_VERSION is 2017.2)
+
#OstreeBloom is an implementation of a bloom filter which supports writing to
+ line="34">#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
@@ -18708,7 +18834,7 @@ Reference:
throws="1">
In many cases using libostree, a program may need to "break"
+ line="781">In many cases using libostree, a program may need to "break"
hardlinks by performing a copy. For example, in order to
logically append to a file.
@@ -18722,7 +18848,7 @@ This function does not perform synchronization via `fsync()` or
`fdatasync()`; the idea is this will commonly be done as part
of an `ostree_repo_commit_transaction()`, which itself takes
care of synchronization.
-
+
@@ -18730,19 +18856,19 @@ care of synchronization.
Directory fd
+ line="783">Directory fd
Path relative to @dfd
+ line="784">Path relative to @dfd
Do not copy extended attributes
+ line="785">Do not copy extended attributes
-
+
%TRUE if current libostree has at least the requested version, %FALSE otherwise
+ line="2741">%TRUE if current libostree has at least the requested version, %FALSE otherwise
Major/year required
+ line="2738">Major/year required
Release version required
+ line="2739">Release version required
@@ -18781,11 +18907,11 @@ care of synchronization.
-
+
Modified base64 encoding of @csum
+ line="1567">Modified base64 encoding of @csum
The "modified" term refers to the fact that instead of '/', the '_'
character is used.
@@ -18795,7 +18921,7 @@ character is used.
An binary checksum of length 32
+ line="1565">An binary checksum of length 32
@@ -18807,10 +18933,10 @@ character is used.
introspectable="0">
Overwrite the contents of @buf with modified base64 encoding of @csum.
+ line="1495">Overwrite the contents of @buf with modified base64 encoding of @csum.
The "modified" term refers to the fact that instead of '/', the '_'
character is used.
-
+
@@ -18818,7 +18944,7 @@ character is used.
An binary checksum of length 32
+ line="1497">An binary checksum of length 32
@@ -18826,7 +18952,7 @@ character is used.
Output location, must be at least 44 bytes in length
+ line="1498">Output location, must be at least 44 bytes in length
@@ -18836,8 +18962,8 @@ character is used.
introspectable="0">
Overwrite the contents of @buf with stringified version of @csum.
-
+ line="1376">Overwrite the contents of @buf with stringified version of @csum.
+
@@ -18845,7 +18971,7 @@ character is used.
An binary checksum of length 32
+ line="1378">An binary checksum of length 32
@@ -18853,7 +18979,7 @@ character is used.
Output location, must be at least 45 bytes in length
+ line="1379">Output location, must be at least 45 bytes in length
@@ -18861,11 +18987,11 @@ character is used.
-
+
Binary version of @checksum.
+ line="1469">Binary version of @checksum.
@@ -18874,18 +19000,18 @@ character is used.
An ASCII checksum
+ line="1467">An ASCII checksum
-
+
Binary checksum data in @bytes; do not free. If @bytes does not have the correct length, return %NULL.
+ line="1586">Binary checksum data in @bytes; do not free. If @bytes does not have the correct length, return %NULL.
@@ -18894,7 +19020,7 @@ character is used.
#GVariant of type ay
+ line="1584">#GVariant of type ay
@@ -18904,12 +19030,12 @@ character is used.
throws="1">
Like ostree_checksum_bytes_peek(), but also throws @error.
-
+ line="1599">Like ostree_checksum_bytes_peek(), but also throws @error.
+
Binary checksum data
+ line="1606">Binary checksum data
@@ -18918,7 +19044,7 @@ character is used.
#GVariant of type ay
+ line="1601">#GVariant of type ay
@@ -18928,8 +19054,8 @@ character is used.
throws="1">
Compute the OSTree checksum for a given file.
-
+ line="892">Compute the OSTree checksum for a given file.
+
@@ -18937,13 +19063,13 @@ character is used.
File path
+ line="894">File path
Object type
+ line="895">Object type
transfer-ownership="full">
Return location for binary checksum
+ line="896">Return location for binary checksum
@@ -18963,7 +19089,7 @@ character is used.
allow-none="1">
Cancellable
+ line="897">Cancellable
@@ -18972,9 +19098,9 @@ character is used.
c:identifier="ostree_checksum_file_async">
Asynchronously compute the OSTree checksum for a given file;
+ line="1059">Asynchronously compute the OSTree checksum for a given file;
complete with ostree_checksum_file_async_finish().
-
+
@@ -18982,19 +19108,19 @@ complete with ostree_checksum_file_async_finish().
File path
+ line="1061">File path
Object type
+ line="1062">Object type
Priority for operation, see %G_IO_PRIORITY_DEFAULT
+ line="1063">Priority for operation, see %G_IO_PRIORITY_DEFAULT
allow-none="1">
Cancellable
+ line="1064">Cancellable
closure="5">
Invoked when operation is complete
+ line="1065">Invoked when operation is complete
allow-none="1">
Data for @callback
+ line="1066">Data for @callback
@@ -19033,9 +19159,9 @@ complete with ostree_checksum_file_async_finish().
throws="1">
Finish computing the OSTree checksum for a given file; see
+ line="1093">Finish computing the OSTree checksum for a given file; see
ostree_checksum_file_async().
-
+
@@ -19043,13 +19169,13 @@ ostree_checksum_file_async().
File path
+ line="1095">File path
Async result
+ line="1096">Async result
transfer-ownership="full">
Return location for binary checksum
+ line="1097">Return location for binary checksum
@@ -19071,10 +19197,10 @@ ostree_checksum_file_async().
throws="1">
Compute the OSTree checksum for a given file. This is an fd-relative version
+ line="944">Compute the OSTree checksum for a given file. This is an fd-relative version
of ostree_checksum_file() which also takes flags and fills in a caller
allocated buffer.
-
+
@@ -19082,13 +19208,13 @@ allocated buffer.
Directory file descriptor
+ line="946">Directory file descriptor
Subpath
+ line="947">Subpath
@stbuf (allow-none): Optional stat buffer
@@ -19101,13 +19227,13 @@ allocated buffer.
Object type
+ line="949">Object type
Flags
+ line="950">Flags
@out_checksum (out) (transfer full): Return location for hex checksum
@@ -19120,7 +19246,7 @@ allocated buffer.
allow-none="1">
Cancellable
+ line="952">Cancellable
@@ -19130,8 +19256,8 @@ allocated buffer.
throws="1">
Compute the OSTree checksum for a given input.
-
+ line="838">Compute the OSTree checksum for a given input.
+
@@ -19139,7 +19265,7 @@ allocated buffer.
File information
+ line="840">File information
allow-none="1">
Optional extended attributes
+ line="841">Optional extended attributes
allow-none="1">
File content, should be %NULL for symbolic links
+ line="842">File content, should be %NULL for symbolic links
Object type
+ line="843">Object type
transfer-ownership="full">
Return location for binary checksum
+ line="844">Return location for binary checksum
@@ -19183,25 +19309,25 @@ allocated buffer.
allow-none="1">
Cancellable
+ line="845">Cancellable
-
+
String form of @csum
+ line="1541">String form of @csum
An binary checksum of length 32
+ line="1539">An binary checksum of length 32
@@ -19210,18 +19336,18 @@ allocated buffer.
-
+
String form of @csum_bytes
+ line="1555">String form of @csum_bytes
#GVariant of type ay
+ line="1553">#GVariant of type ay
@@ -19231,8 +19357,8 @@ allocated buffer.
introspectable="0">
Overwrite the contents of @buf with stringified version of @csum.
-
+ line="1481">Overwrite the contents of @buf with stringified version of @csum.
+
@@ -19240,7 +19366,7 @@ allocated buffer.
An binary checksum of length 32
+ line="1483">An binary checksum of length 32
@@ -19248,7 +19374,7 @@ allocated buffer.
Output location, must be at least OSTREE_SHA256_STRING_LEN+1 bytes in length
+ line="1484">Output location, must be at least OSTREE_SHA256_STRING_LEN+1 bytes in length
@@ -19257,9 +19383,9 @@ allocated buffer.
c:identifier="ostree_checksum_inplace_to_bytes">
Convert @checksum from a string to binary in-place, without
+ line="1405">Convert @checksum from a string to binary in-place, without
allocating memory. Use this function in hot code paths.
-
+
@@ -19267,23 +19393,23 @@ allocating memory. Use this function in hot code paths.
a SHA256 string
+ line="1407">a SHA256 string
Output buffer with at least 32 bytes of space
+ line="1408">Output buffer with at least 32 bytes of space
-
+
Binary checksum from @checksum of length 32; free with g_free().
+ line="1441">Binary checksum from @checksum of length 32; free with g_free().
@@ -19292,31 +19418,31 @@ allocating memory. Use this function in hot code paths.
An ASCII checksum
+ line="1439">An ASCII checksum
-
+
New #GVariant of type ay with length 32
+ line="1455">New #GVariant of type ay with length 32
An ASCII checksum
+ line="1453">An ASCII checksum
-
+
@@ -19325,8 +19451,8 @@ allocating memory. Use this function in hot code paths.
c:identifier="ostree_cmp_checksum_bytes">
Compare two binary checksums, using memcmp().
-
+ line="1327">Compare two binary checksums, using memcmp().
+
@@ -19334,13 +19460,13 @@ allocating memory. Use this function in hot code paths.
A binary checksum
+ line="1329">A binary checksum
A binary checksum
+ line="1330">A binary checksum
@@ -19351,14 +19477,14 @@ allocating memory. Use this function in hot code paths.
version="2018.6">
Copy an array of #OstreeCollectionRefs, including deep copies of all its
+ line="145">Copy an array of #OstreeCollectionRefs, including deep copies of all its
elements. @refs must be %NULL-terminated; it may be empty, but must not be
%NULL.
-
+
a newly allocated copy of @refs
+ line="153">a newly allocated copy of @refs
@@ -19367,7 +19493,7 @@ elements. @refs must be %NULL-terminated; it may be empty, but must not be
%NULL-terminated array of #OstreeCollectionRefs
+ line="147">%NULL-terminated array of #OstreeCollectionRefs
@@ -19380,26 +19506,26 @@ elements. @refs must be %NULL-terminated; it may be empty, but must not be
version="2018.6">
Compare @ref1 and @ref2 and return %TRUE if they have the same collection ID and
+ line="124">Compare @ref1 and @ref2 and return %TRUE if they have the same collection ID and
ref name, and %FALSE otherwise. Both @ref1 and @ref2 must be non-%NULL.
-
+
%TRUE if @ref1 and @ref2 are equal, %FALSE otherwise
+ line="132">%TRUE if @ref1 and @ref2 are equal, %FALSE otherwise
an #OstreeCollectionRef
+ line="126">an #OstreeCollectionRef
another #OstreeCollectionRef
+ line="127">another #OstreeCollectionRef
@@ -19410,9 +19536,9 @@ ref name, and %FALSE otherwise. Both @ref1 and @ref2 must be non-%NULL.
version="2018.6">
Free the given array of @refs, including freeing all its elements. @refs
+ line="173">Free the given array of @refs, including freeing all its elements. @refs
must be %NULL-terminated; it may be empty, but must not be %NULL.
-
+
@@ -19420,7 +19546,7 @@ must be %NULL-terminated; it may be empty, but must not be %NULL.
an array of #OstreeCollectionRefs
+ line="175">an array of #OstreeCollectionRefs
@@ -19433,20 +19559,20 @@ must be %NULL-terminated; it may be empty, but must not be %NULL.
version="2018.6">
Hash the given @ref. This function is suitable for use with #GHashTable.
+ line="103">Hash the given @ref. This function is suitable for use with #GHashTable.
@ref must be non-%NULL.
-
+
hash value for @ref
+ line="110">hash value for @ref
an #OstreeCollectionRef
+ line="105">an #OstreeCollectionRef
@@ -19456,7 +19582,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="2422">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.
@@ -19467,18 +19593,18 @@ cases where nothing actually changed.
The content checksums is simply defined as `SHA256(root dirtree_checksum || root_dirmeta_checksum)`,
i.e. the SHA-256 of the root "dirtree" object's checksum concatenated with the
root "dirmeta" checksum (both in binary form, not hexadecimal).
-
+
A SHA-256 hex string, or %NULL if @commit_variant is not well-formed
+ line="2438">A SHA-256 hex string, or %NULL if @commit_variant is not well-formed
A commit object
+ line="2424">A commit object
@@ -19489,12 +19615,12 @@ root "dirmeta" checksum (both in binary form, not hexadecimal).
throws="1">
Reads a commit's "ostree.sizes" metadata and returns an array of
+ line="2596">Reads a commit's "ostree.sizes" metadata and returns an array of
#OstreeCommitSizesEntry in @out_sizes_entries. Each element
represents an object in the commit. If the commit does not contain
the "ostree.sizes" metadata, a %G_IO_ERROR_NOT_FOUND error will be
returned.
-
+
@@ -19502,7 +19628,7 @@ returned.
variant of type %OSTREE_OBJECT_TYPE_COMMIT
+ line="2598">variant of type %OSTREE_OBJECT_TYPE_COMMIT
allow-none="1">
+ line="2599">
return location for an array of object size entries
@@ -19522,11 +19648,11 @@ returned.
-
+
Checksum of the parent commit of @commit_variant, or %NULL
+ line="2393">Checksum of the parent commit of @commit_variant, or %NULL
if none
@@ -19534,7 +19660,7 @@ if none
Variant of type %OSTREE_OBJECT_TYPE_COMMIT
+ line="2391">Variant of type %OSTREE_OBJECT_TYPE_COMMIT
@@ -19542,18 +19668,18 @@ if none
-
+
timestamp in seconds since the Unix epoch, UTC
+ line="2410">timestamp in seconds since the Unix epoch, UTC
Commit object
+ line="2408">Commit object
@@ -19564,8 +19690,8 @@ if none
throws="1">
Update provided @dict with standard metadata for bootable OSTree commits.
-
+ line="31">Update provided @dict with standard metadata for bootable OSTree commits.
+
@@ -19573,13 +19699,13 @@ if none
Root filesystem to be committed
+ line="33">Root filesystem to be committed
Dictionary to update
+ line="34">Dictionary to update
throws="1">
A thin wrapper for ostree_content_stream_parse(); this function
+ line="706">A thin wrapper for ostree_content_stream_parse(); this function
converts an object content stream back into components.
-
+
@@ -19605,19 +19731,19 @@ converts an object content stream back into components.
Whether or not the stream is zlib-compressed
+ line="708">Whether or not the stream is zlib-compressed
Path to file containing content
+ line="709">Path to file containing content
If %TRUE, assume the content has been validated
+ line="710">If %TRUE, assume the content has been validated
transfer-ownership="full">
The raw file content stream
+ line="711">The raw file content stream
transfer-ownership="full">
Normal metadata
+ line="712">Normal metadata
transfer-ownership="full">
Extended attributes
+ line="713">Extended attributes
allow-none="1">
Cancellable
+ line="714">Cancellable
@@ -19663,9 +19789,9 @@ converts an object content stream back into components.
throws="1">
A thin wrapper for ostree_content_stream_parse(); this function
+ line="655">A thin wrapper for ostree_content_stream_parse(); this function
converts an object content stream back into components.
-
+
@@ -19673,25 +19799,25 @@ converts an object content stream back into components.
Whether or not the stream is zlib-compressed
+ line="657">Whether or not the stream is zlib-compressed
Directory file descriptor
+ line="658">Directory file descriptor
Subpath
+ line="659">Subpath
If %TRUE, assume the content has been validated
+ line="660">If %TRUE, assume the content has been validated
transfer-ownership="full">
The raw file content stream
+ line="661">The raw file content stream
transfer-ownership="full">
Normal metadata
+ line="662">Normal metadata
transfer-ownership="full">
Extended attributes
+ line="663">Extended attributes
allow-none="1">
Cancellable
+ line="664">Cancellable
@@ -19737,9 +19863,9 @@ converts an object content stream back into components.
throws="1">
The reverse of ostree_raw_file_to_content_stream(); this function
+ line="556">The reverse of ostree_raw_file_to_content_stream(); this function
converts an object content stream back into components.
-
+
@@ -19747,25 +19873,25 @@ converts an object content stream back into components.
Whether or not the stream is zlib-compressed
+ line="558">Whether or not the stream is zlib-compressed
Object content stream
+ line="559">Object content stream
Length of stream
+ line="560">Length of stream
If %TRUE, assume the content has been validated
+ line="561">If %TRUE, assume the content has been validated
transfer-ownership="full">
The raw file content stream
+ line="562">The raw file content stream
transfer-ownership="full">
Normal metadata
+ line="563">Normal metadata
transfer-ownership="full">
Extended attributes
+ line="564">Extended attributes
allow-none="1">
Cancellable
+ line="565">Cancellable
-
+
A new #GVariant containing %OSTREE_OBJECT_TYPE_DIR_META
+ line="1145">A new #GVariant containing %OSTREE_OBJECT_TYPE_DIR_META
a #GFileInfo containing directory information
+ line="1142">a #GFileInfo containing directory information
allow-none="1">
Optional extended attributes
+ line="1143">Optional extended attributes
@@ -19836,9 +19962,9 @@ converts an object content stream back into components.
Compute the difference between directory @a and @b as 3 separate
+ line="197">Compute the difference between directory @a and @b as 3 separate
sets of #OstreeDiffItem in @modified, @removed, and @added.
-
+
@@ -19846,25 +19972,25 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
Flags
+ line="199">Flags
First directory path, or %NULL
+ line="200">First directory path, or %NULL
First directory path
+ line="201">First directory path
Modified files
+ line="202">Modified files
@@ -19872,7 +19998,7 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
Removed files
+ line="203">Removed files
@@ -19880,7 +20006,7 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
Added files
+ line="204">Added files
@@ -19891,7 +20017,7 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
allow-none="1">
Cancellable
+ line="205">Cancellable
@@ -19902,9 +20028,9 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
throws="1">
Compute the difference between directory @a and @b as 3 separate
+ line="226">Compute the difference between directory @a and @b as 3 separate
sets of #OstreeDiffItem in @modified, @removed, and @added.
-
+
@@ -19912,25 +20038,25 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
Flags
+ line="228">Flags
First directory path, or %NULL
+ line="229">First directory path, or %NULL
First directory path
+ line="230">First directory path
Modified files
+ line="231">Modified files
@@ -19938,7 +20064,7 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
Removed files
+ line="232">Removed files
@@ -19946,7 +20072,7 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
Added files
+ line="233">Added files
@@ -19957,7 +20083,7 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
allow-none="1">
Options
+ line="235">Options
allow-none="1">
Cancellable
+ line="234">Cancellable
@@ -19974,8 +20100,8 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
Print the contents of a diff to stdout.
-
+ line="478">Print the contents of a diff to stdout.
+
@@ -19983,19 +20109,19 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
First directory path
+ line="480">First directory path
First directory path
+ line="481">First directory path
Modified files
+ line="482">Modified files
@@ -20003,7 +20129,7 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
Removed files
+ line="483">Removed files
@@ -20011,7 +20137,7 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
Added files
+ line="484">Added files
@@ -20028,8 +20154,8 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
Use this function with #GHashTable and ostree_object_name_serialize().
-
+ line="1308">Use this function with #GHashTable and ostree_object_name_serialize().
+
@@ -20040,7 +20166,7 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
allow-none="1">
A #GVariant containing a serialized object
+ line="1310">A #GVariant containing a serialized object
@@ -20051,8 +20177,8 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
version="2019.3">
Frees the OstreeKernelArgs structure pointed by *loc
-
+ line="214">Frees the OstreeKernelArgs structure pointed by *loc
+
@@ -20063,7 +20189,7 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
allow-none="1">
Address of an OstreeKernelArgs pointer
+ line="216">Address of an OstreeKernelArgs pointer
@@ -20075,20 +20201,20 @@ sets of #OstreeDiffItem in @modified, @removed, and @added.
introspectable="0">
Initializes a new OstreeKernelArgs then parses and appends @options
+ line="681">Initializes a new OstreeKernelArgs then parses and appends @options
to the empty OstreeKernelArgs
-
+
newly allocated #OstreeKernelArgs with @options appended
+ line="688">newly allocated #OstreeKernelArgs with @options appended
a string representing command line arguments
+ line="683">a string representing command line arguments
@@ -20100,18 +20226,18 @@ to the empty OstreeKernelArgs
introspectable="0">
Initializes a new OstreeKernelArgs structure and returns it
-
+ line="174">Initializes a new OstreeKernelArgs structure and returns it
+
A newly created #OstreeKernelArgs for kernel arguments
+ line="179">A newly created #OstreeKernelArgs for kernel arguments
-
+
@@ -20125,8 +20251,8 @@ to the empty OstreeKernelArgs
c:identifier="ostree_object_from_string">
Reverse ostree_object_to_string().
-
+ line="1287">Reverse ostree_object_to_string().
+
@@ -20134,7 +20260,7 @@ to the empty OstreeKernelArgs
An ASCII checksum
+ line="1289">An ASCII checksum
transfer-ownership="full">
Parsed checksum
+ line="1290">Parsed checksum
transfer-ownership="full">
Parsed object type
+ line="1291">Parsed object type
@@ -20161,9 +20287,9 @@ to the empty OstreeKernelArgs
c:identifier="ostree_object_name_deserialize">
Reverse ostree_object_name_serialize(). Note that @out_checksum is
+ line="1357">Reverse ostree_object_name_serialize(). Note that @out_checksum is
only valid for the lifetime of @variant, and must not be freed.
-
+
@@ -20171,7 +20297,7 @@ only valid for the lifetime of @variant, and must not be freed.
A #GVariant of type (su)
+ line="1359">A #GVariant of type (su)
transfer-ownership="none">
Pointer into string memory of @variant with checksum
+ line="1360">Pointer into string memory of @variant with checksum
transfer-ownership="full">
Return object type
+ line="1361">Return object type
-
+
A new floating #GVariant containing checksum string and objtype
+ line="1346">A new floating #GVariant containing checksum string and objtype
An ASCII checksum
+ line="1343">An ASCII checksum
An object type
+ line="1344">An object type
-
+
A string containing both @checksum and a stringifed version of @objtype
+ line="1278">A string containing both @checksum and a stringifed version of @objtype
An ASCII checksum
+ line="1275">An ASCII checksum
Object type
+ line="1276">Object type
@@ -20245,8 +20371,8 @@ only valid for the lifetime of @variant, and must not be freed.
c:identifier="ostree_object_type_from_string">
The reverse of ostree_object_type_to_string().
-
+ line="1242">The reverse of ostree_object_type_to_string().
+
@@ -20254,7 +20380,7 @@ only valid for the lifetime of @variant, and must not be freed.
A stringified version of #OstreeObjectType
+ line="1244">A stringified version of #OstreeObjectType
@@ -20263,8 +20389,8 @@ only valid for the lifetime of @variant, and must not be freed.
c:identifier="ostree_object_type_to_string">
Serialize @objtype to a string; this is used for file extensions.
-
+ line="1207">Serialize @objtype to a string; this is used for file extensions.
+
@@ -20272,7 +20398,7 @@ only valid for the lifetime of @variant, and must not be freed.
an #OstreeObjectType
+ line="1209">an #OstreeObjectType
@@ -20280,7 +20406,7 @@ only valid for the lifetime of @variant, and must not be freed.
For many asynchronous operations, it's desirable for callers to be
+ line="26">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.
@@ -20299,7 +20425,7 @@ must always have the correct type.
These functions implement repository-independent algorithms for
+ line="94">These functions implement repository-independent algorithms for
operating on the core OSTree data formats, such as converting
#GFileInfo into a #GVariant.
@@ -20317,7 +20443,7 @@ The file object is a custom format in order to support streaming.
#OstreeGpgVerifyResult contains verification details for GPG signatures
+ line="28">#OstreeGpgVerifyResult contains verification details for GPG signatures
read from a detached #OstreeRepo metadata object.
Use ostree_gpg_verify_result_count_all() and
@@ -20346,7 +20472,7 @@ LZMA.
In order to commit content into an #OstreeRepo, it must first be
+ line="29">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
@@ -20355,7 +20481,7 @@ programmatically.
The #OstreeRepo is like git, a content-addressed object store.
+ line="85">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
@@ -20407,7 +20533,7 @@ collection IDs, see ostree_validate_collection_id().
#OstreeRepoFinderAvahi is an implementation of #OstreeRepoFinder which looks
+ line="60">#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,
@@ -20442,7 +20568,7 @@ each peer, including the services’ TXT records.
#OstreeRepoFinderConfig is an implementation of #OstreeRepoFinder which looks
+ line="38">#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.
@@ -20456,7 +20582,7 @@ do not have their `collection-id` key configured are ignored.
#OstreeRepoFinderMount is an implementation of #OstreeRepoFinder which looks
+ line="38">#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
@@ -20482,7 +20608,7 @@ The volume monitor used to find mounted volumes can be overridden by setting
#OstreeRepoFinderOverride is an implementation of #OstreeRepoFinder which
+ line="38">#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.
@@ -20502,19 +20628,19 @@ recommended instead.
A #OstreeSePolicy object can load the SELinux policy from a given
+ line="35">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
+ line="23">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,
+ line="39">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.
@@ -20526,13 +20652,13 @@ perform locking externally.
The #OstreeSysrootUpgrader class allows performing simple upgrade
+ line="28">The #OstreeSysrootUpgrader class allows performing simple upgrade
operations.
ostree provides macros to check the version of the library
+ line="20">ostree provides macros to check the version of the library
at compile-time
throws="1">
Split a refspec like `gnome-ostree:gnome-ostree/buildmain` or just
+ line="154">Split a refspec like `gnome-ostree:gnome-ostree/buildmain` or just
`gnome-ostree/buildmain` into two parts. In the first case, @out_remote
will be set to `gnome-ostree`, and @out_ref to `gnome-ostree/buildmain`.
In the second case (a local ref), @out_remote will be %NULL, and @out_ref
will be `gnome-ostree/buildmain`. In both cases, %TRUE will be returned.
-
+
%TRUE on successful parsing, %FALSE otherwise
+ line="168">%TRUE on successful parsing, %FALSE otherwise
A "refspec" string
+ line="156">A "refspec" string
allow-none="1">
Return location for the remote name,
+ line="157">Return location for the remote name,
or %NULL if the refspec refs to a local ref
@@ -20580,7 +20706,7 @@ will be `gnome-ostree/buildmain`. In both cases, %TRUE will be returned.
allow-none="1">
Return location for the ref name
+ line="159">Return location for the ref name
@@ -20591,9 +20717,9 @@ will be `gnome-ostree/buildmain`. In both cases, %TRUE will be returned.
throws="1">
Convert from a "bare" file representation into an
+ line="459">Convert from a "bare" file representation into an
OSTREE_OBJECT_TYPE_FILE stream suitable for ostree pull.
-
+
@@ -20601,13 +20727,13 @@ OSTREE_OBJECT_TYPE_FILE stream suitable for ostree pull.
File raw content stream
+ line="461">File raw content stream
A file info
+ line="462">A file info
allow-none="1">
Optional extended attributes
+ line="463">Optional extended attributes
transfer-ownership="full">
Serialized object stream
+ line="464">Serialized object stream
allow-none="1">
Cancellable
+ line="465">Cancellable
@@ -20645,12 +20771,12 @@ OSTREE_OBJECT_TYPE_FILE stream suitable for ostree pull.
throws="1">
Like ostree_raw_file_to_archive_z2_stream(), but supports an extensible set
+ line="486">Like ostree_raw_file_to_archive_z2_stream(), but supports an extensible set
of flags. The following flags are currently defined:
- `compression-level` (`i`): Level of compression to use, 0–9, with 0 being
the least compression, and <0 giving the default level (currently 6).
-
+
@@ -20658,13 +20784,13 @@ of flags. The following flags are currently defined:
File raw content stream
+ line="488">File raw content stream
A file info
+ line="489">A file info
Optional extended attributes
+ line="490">Optional extended attributes
A GVariant `a{sv}` with an extensible set of flags
+ line="491">A GVariant `a{sv}` with an extensible set of flags
Serialized object stream
+ line="492">Serialized object stream
Cancellable
+ line="493">Cancellable
@@ -20710,10 +20836,10 @@ of flags. The following flags are currently defined:
throws="1">
Convert from a "bare" file representation into an
+ line="526">Convert from a "bare" file representation into an
OSTREE_OBJECT_TYPE_FILE stream. This is a fundamental operation
for writing data to an #OstreeRepo.
-
+
@@ -20721,13 +20847,13 @@ for writing data to an #OstreeRepo.
File raw content stream
+ line="528">File raw content stream
A file info
+ line="529">A file info
allow-none="1">
Optional extended attributes
+ line="530">Optional extended attributes
transfer-ownership="full">
Serialized object stream
+ line="531">Serialized object stream
transfer-ownership="full">
Length of stream
+ line="532">Length of stream
allow-none="1">
Cancellable
+ line="533">Cancellable
@@ -20771,7 +20897,7 @@ for writing data to an #OstreeRepo.
The #OstreeRemote structure represents the configuration for a single remote
+ line="38">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).
@@ -20784,7 +20910,7 @@ refs are currently on a remote, or the commits they currently point to. Use
-
+
@@ -20803,9 +20929,9 @@ refs are currently on a remote, or the commits they currently point to. Use
version="2018.6">
A version of ostree_repo_finder_resolve_async() which queries one or more
+ line="243">A version of ostree_repo_finder_resolve_async() which queries one or more
@finders in parallel and combines the results.
-
+
@@ -20813,7 +20939,7 @@ refs are currently on a remote, or the commits they currently point to. Use
non-empty array of #OstreeRepoFinders
+ line="245">non-empty array of #OstreeRepoFinders
@@ -20821,7 +20947,7 @@ refs are currently on a remote, or the commits they currently point to. Use
non-empty array of collection–ref pairs to find remotes for
+ line="246">non-empty array of collection–ref pairs to find remotes for
@@ -20829,7 +20955,7 @@ refs are currently on a remote, or the commits they currently point to. Use
the local repository which the refs are being resolved for,
+ line="247">the local repository which the refs are being resolved for,
which provides configuration information and GPG keys
@@ -20839,7 +20965,7 @@ refs are currently on a remote, or the commits they currently point to. Use
allow-none="1">
a #GCancellable, or %NULL
+ line="249">a #GCancellable, or %NULL
asynchronous completion callback
+ line="250">asynchronous completion callback
data to pass to @callback
+ line="251">data to pass to @callback
@@ -20871,12 +20997,12 @@ refs are currently on a remote, or the commits they currently point to. Use
throws="1">
Get the results from a ostree_repo_finder_resolve_all_async() operation.
-
+ line="404">Get the results from a ostree_repo_finder_resolve_all_async() operation.
+
array of zero
+ line="411">array of zero
or more results
@@ -20886,7 +21012,7 @@ refs are currently on a remote, or the commits they currently point to. Use
#GAsyncResult from the callback
+ line="406">#GAsyncResult from the callback
@@ -20897,8 +21023,8 @@ refs are currently on a remote, or the commits they currently point to. Use
version="2018.6">
Free the given @results array, freeing each element and the container.
-
+ line="567">Free the given @results array, freeing each element and the container.
+
@@ -20906,7 +21032,7 @@ refs are currently on a remote, or the commits they currently point to. Use
an #OstreeRepoFinderResult
+ line="569">an #OstreeRepoFinderResult
@@ -20919,13 +21045,13 @@ refs are currently on a remote, or the commits they currently point to. Use
version="2020.2">
Return an array with newly allocated instances of all available
+ line="518">Return an array with newly allocated instances of all available
signing engines; they will not be initialized.
-
+
an array of signing engines
+ line="524">an array of signing engines
@@ -20938,59 +21064,41 @@ signing engines; they will not be initialized.
throws="1">
Create a new instance of a signing engine.
-
+ line="542">Create a new instance of a signing engine.
+
New signing engine, or %NULL if the engine is not known
+ line="549">New signing engine, or %NULL if the engine is not known
the name of desired signature engine
+ line="544">the name of desired signature engine
-
- 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.
-
Use this function to see if input strings are checksums.
-
+ line="131">Use this function to see if input strings are checksums.
+
%TRUE if @sha256 is a valid checksum string, %FALSE otherwise
+ line="138">%TRUE if @sha256 is a valid checksum string, %FALSE otherwise
SHA256 hex string
+ line="133">SHA256 hex string
@@ -21001,7 +21109,7 @@ in the server callback.
throws="1">
Check whether the given @collection_id is valid. Return an error if it is
+ line="284">Check whether the given @collection_id is valid. Return an error if it is
invalid or %NULL.
Valid collection IDs are reverse DNS names:
@@ -21014,11 +21122,11 @@ Valid collection IDs are reverse DNS names:
* They must not exceed 255 characters in length.
(This makes their format identical to D-Bus interface names, for consistency.)
-
+
%TRUE if @collection_id is a valid collection ID, %FALSE if it is invalid
+ line="303">%TRUE if @collection_id is a valid collection ID, %FALSE if it is invalid
or %NULL
@@ -21029,7 +21137,7 @@ Valid collection IDs are reverse DNS names:
allow-none="1">
A collection ID
+ line="286">A collection ID
@@ -21038,18 +21146,18 @@ Valid collection IDs are reverse DNS names:
c:identifier="ostree_validate_remote_name"
version="2017.8"
throws="1">
-
+
%TRUE if @remote_name is a valid remote name
+ line="260">%TRUE if @remote_name is a valid remote name
A remote name
+ line="257">A remote name
@@ -21057,18 +21165,18 @@ Valid collection IDs are reverse DNS names:
-
+
%TRUE if @rev is a valid ref string
+ line="232">%TRUE if @rev is a valid ref string
A revision string
+ line="229">A revision string
@@ -21076,18 +21184,18 @@ Valid collection IDs are reverse DNS names:
-
+
%TRUE if @checksum is a valid ASCII SHA256 checksum
+ line="2070">%TRUE if @checksum is a valid ASCII SHA256 checksum
an ASCII string
+ line="2067">an ASCII string
@@ -21097,20 +21205,20 @@ Valid collection IDs are reverse DNS names:
throws="1">
Use this to validate the basic structure of @commit, independent of
+ line="2194">Use this to validate the basic structure of @commit, independent of
any other objects it references.
-
+
%TRUE if @commit is structurally valid
+ line="2202">%TRUE if @commit is structurally valid
A commit object, %OSTREE_OBJECT_TYPE_COMMIT
+ line="2196">A commit object, %OSTREE_OBJECT_TYPE_COMMIT
@@ -21118,18 +21226,18 @@ any other objects it references.
-
+
%TRUE if @checksum is a valid binary SHA256 checksum
+ line="2056">%TRUE if @checksum is a valid binary SHA256 checksum
a #GVariant of type "ay"
+ line="2053">a #GVariant of type "ay"
@@ -21139,19 +21247,19 @@ any other objects it references.
throws="1">
Use this to validate the basic structure of @dirmeta.
-
+ line="2359">Use this to validate the basic structure of @dirmeta.
+
%TRUE if @dirmeta is structurally valid
+ line="2366">%TRUE if @dirmeta is structurally valid
A dirmeta object, %OSTREE_OBJECT_TYPE_DIR_META
+ line="2361">A dirmeta object, %OSTREE_OBJECT_TYPE_DIR_META
@@ -21161,20 +21269,20 @@ any other objects it references.
throws="1">
Use this to validate the basic structure of @dirtree, independent of
+ line="2247">Use this to validate the basic structure of @dirtree, independent of
any other objects it references.
-
+
%TRUE if @dirtree is structurally valid
+ line="2255">%TRUE if @dirtree is structurally valid
A dirtree object, %OSTREE_OBJECT_TYPE_DIR_TREE
+ line="2249">A dirtree object, %OSTREE_OBJECT_TYPE_DIR_TREE
@@ -21182,18 +21290,18 @@ any other objects it references.
-
+
%TRUE if @mode represents a valid file type and permissions
+ line="2344">%TRUE if @mode represents a valid file type and permissions
A Unix filesystem mode
+ line="2341">A Unix filesystem mode
@@ -21201,11 +21309,11 @@ any other objects it references.
-
+
%TRUE if @objtype represents a valid object type
+ line="2038">%TRUE if @objtype represents a valid object type