Since: 2020.4
verbose: b: Print diagnostic messages. Default FALSE.
endianness: b: Deltas use host byte order by default; this option allows choosing (G_BIG_ENDIAN or G_LITTLE_ENDIAN)
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.
gboolean +ostree_repo_static_delta_execute_offline_with_signature + (+OstreeRepo *self, +GFile *dir_or_file, +OstreeSign *sign, +gboolean skip_validation, +GCancellable *cancellable, +GError **error);
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, +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.
+self |
+Repo |
++ |
dir_or_file |
+Path to a directory containing static delta data, or directly to the superblock |
++ |
sign |
+Signature engine used to check superblock |
++ |
skip_validation |
+If |
++ |
cancellable |
+Cancellable |
++ |
error |
+Error |
++ |
Since: 2020.7
+gboolean
ostree_repo_static_delta_execute_offline
@@ -6579,6 +6661,61 @@ must contain a file named "superblock", along with at least one part.
gboolean +ostree_repo_static_delta_verify_signature + (+OstreeRepo *self, +const char *delta_id, +OstreeSign *sign, +char **out_success_message, +GError **error);
Verify static delta file signature.
+self |
+Repo |
++ |
delta_id |
+delta path |
++ |
sign |
+Signature engine used to check superblock |
++ |
out_success_message |
+success message |
++ |
error |
+Error |
++ |
TRUE if the signature of static delta file is valid using the +signature engine provided, FALSE otherwise.
+Since: 2020.7
+GHashTable *
ostree_repo_traverse_new_reachable (void);
@@ -7455,37 +7592,37 @@ ostree_repo_pull_with_options (Like ostree_repo_pull(), but supports an extensible set of flags.
The following are currently defined:
-refs (as): Array of string refs
collection-refs (a(sss)): Array of (collection ID, ref name, checksum) tuples to pull;
+
refs (as): Array of string refs
collection-refs (a(sss)): Array of (collection ID, ref name, checksum) tuples to pull;
mutually exclusive with refs and override-commit-ids. Checksums may be the empty
string to pull the latest commit for that ref
flags (i): An instance of OstreeRepoPullFlags
subdir (s): Pull just this subdirectory
subdirs (as): Pull just these subdirectories
override-remote-name (s): If local, add this remote to refspec
gpg-verify (b): GPG verify commits
gpg-verify-summary (b): GPG verify summary
disable-sign-verify (b): Disable signapi verification of commits
disable-sign-verify-summary (b): Disable signapi verification of the summary
depth (i): How far in the history to traverse; default is 0, -1 means infinite
per-object-fsync (b): Perform disk writes more slowly, avoiding a single large I/O sync
disable-static-deltas (b): Do not use static deltas
require-static-deltas (b): Require static deltas
override-commit-ids (as): Array of specific commit IDs to fetch for refs
timestamp-check (b): Verify commit timestamps are newer than current (when pulling via ref); Since: 2017.11
timestamp-check-from-rev (s): Verify that all fetched commit timestamps are newer than timestamp of given rev; Since: 2020.4
metadata-size-restriction (t): Restrict metadata objects to a maximum number of bytes; 0 to disable. Since: 2018.9
dry-run (b): Only print information on what will be downloaded (requires static deltas)
override-url (s): Fetch objects from this URL if remote specifies no metalink in options
inherit-transaction (b): Don't initiate, finish or abort a transaction, useful to do multiple pulls in one transaction.
http-headers (a(ss)): Additional headers to add to all HTTP requests
update-frequency (u): Frequency to call the async progress callback in milliseconds, if any; only values higher than 0 are valid
localcache-repos (as): File paths for local repos to use as caches when doing remote fetches
append-user-agent (s): Additional string to append to the user agent
n-network-retries (u): Number of times to retry each download on receiving
+
flags (i): An instance of OstreeRepoPullFlags
subdir (s): Pull just this subdirectory
subdirs (as): Pull just these subdirectories
override-remote-name (s): If local, add this remote to refspec
gpg-verify (b): GPG verify commits
gpg-verify-summary (b): GPG verify summary
disable-sign-verify (b): Disable signapi verification of commits
disable-sign-verify-summary (b): Disable signapi verification of the summary
depth (i): How far in the history to traverse; default is 0, -1 means infinite
per-object-fsync (b): Perform disk writes more slowly, avoiding a single large I/O sync
disable-static-deltas (b): Do not use static deltas
require-static-deltas (b): Require static deltas
override-commit-ids (as): Array of specific commit IDs to fetch for refs
timestamp-check (b): Verify commit timestamps are newer than current (when pulling via ref); Since: 2017.11
timestamp-check-from-rev (s): Verify that all fetched commit timestamps are newer than timestamp of given rev; Since: 2020.4
metadata-size-restriction (t): Restrict metadata objects to a maximum number of bytes; 0 to disable. Since: 2018.9
dry-run (b): Only print information on what will be downloaded (requires static deltas)
override-url (s): Fetch objects from this URL if remote specifies no metalink in options
inherit-transaction (b): Don't initiate, finish or abort a transaction, useful to do multiple pulls in one transaction.
http-headers (a(ss)): Additional headers to add to all HTTP requests
update-frequency (u): Frequency to call the async progress callback in milliseconds, if any; only values higher than 0 are valid
localcache-repos (as): File paths for local repos to use as caches when doing remote fetches
append-user-agent (s): Additional string to append to the user agent
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. Since: 2018.6
ref-keyring-map (a(sss)): Array of (collection ID, ref name, keyring
+
ref-keyring-map (a(sss)): Array of (collection ID, ref name, keyring
remote name) tuples specifying which remote's keyring should be used when
doing GPG verification of each collection-ref. This is useful to prevent a
remote from serving malicious updates to refs which did not originate from
diff --git a/apidoc/html/ostree-Root-partition-mount-point.html b/apidoc/html/ostree-Root-partition-mount-point.html
index 3b1b106..91c0d6b 100644
--- a/apidoc/html/ostree-Root-partition-mount-point.html
+++ b/apidoc/html/ostree-Root-partition-mount-point.html
@@ -348,11 +348,35 @@
gboolean
OstreeDeployment **out_new_deploymentGCancellable *cancellable,
GError **error);
-Like ostree_sysroot_deploy_tree(), but "finalization" only occurs at OS
-shutdown time.
Older version of ostree_sysroot_stage_tree_with_options().
self |
+Sysroot |
++ |
osname |
+osname to use for merge deployment. |
+[allow-none] | +
revision |
+Checksum to add |
++ |
origin |
+Origin to use for upgrades. |
+[allow-none] | +
merge_deployment |
+Use this deployment for merge path. |
+[allow-none] | +
opts |
+Options |
++ |
out_new_deployment |
+The new deployment path. |
+[out] | +
cancellable |
+Cancellable |
++ |
error |
+Error |
++ |
Since: 2020.7
+gboolean +ostree_sysroot_stage_overlay_initrd (+OstreeSysroot *self, +int fd, +char **out_checksum, +GCancellable *cancellable, +GError **error);
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.
self |
+Sysroot |
++ |
fd |
+File descriptor to overlay initrd. |
+[transfer none] | +
out_checksum |
+Overlay initrd checksum. |
+[out][transfer full] | +
cancellable |
+Cancellable |
++ |
error |
+Error |
++ |
Since: 2020.7
+gboolean ostree_sysroot_deploy_tree (-OstreeSysroot *self, @@ -1802,12 +1951,7 @@ ostree_sysroot_deploy_tree (,OstreeDeployment **out_new_deploymentGCancellable *cancellable,GError **error);
Check out deployment tree with revision revision
-, performing a 3
-way merge with provided_merge_deployment
- for configuration.
While this API is not deprecated, you most likely want to use the
-ostree_sysroot_stage_tree() API.
Older version of ostree_sysroot_stage_tree_with_options().
Since: 2018.5
+gboolean +ostree_sysroot_deploy_tree_with_options + (+OstreeSysroot *self, +const char *osname, +const char *revision, +GKeyFile *origin, +OstreeDeployment *provided_merge_deployment, +OstreeSysrootDeployTreeOpts *opts, +OstreeDeployment **out_new_deployment, +GCancellable *cancellable, +GError **error);
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.
self |
+Sysroot |
++ |
osname |
+osname to use for merge deployment. |
+[allow-none] | +
revision |
+Checksum to add |
++ |
origin |
+Origin to use for upgrades. |
+[allow-none] | +
provided_merge_deployment |
+Use this deployment for merge path. |
+[allow-none] | +
opts |
+Options. |
+[allow-none] | +
out_new_deployment |
+The new deployment path. |
+[out] | +
cancellable |
+Cancellable |
++ |
error |
+Error |
++ |
Since: 2020.7
out_success_message
success message returned by the signing engine.
cancellable
A GCancellable
signature
-in case of success will contain signature
in case of success will contain signature.
cancellable
out_success_message
success message returned by the signing engine.
error
a GError
TRUE
if summary file has been signed with all provided keys
Since: 2020.2
OstreeBootconfigParser *selfconst char *key);
+void +ostree_bootconfig_parser_set_overlay_initrds + (+OstreeBootconfigParser *self, +char **initrds);
These are rendered as additional initrd keys in the final bootloader configs. The
+base initrd is part of the primary keys.
self |
+Parser |
++ |
initrds |
+Array of overlay
+initrds or |
+[array zero-terminated=1][transfer none][allow-none] | +
Since: 2020.7
+char **
+ostree_bootconfig_parser_get_overlay_initrds
+ (OstreeBootconfigParser *self);
+
+Array of initrds or NULL
+if none are set.
[array zero-terminated=1][transfer none][nullable]
+Since: 2020.7
+TRUE iff this deployment is staged
Checksums of staged additional initrds for this deployment
Unique ID generated from initrd checksums; used to compare deployments