976 lines
45 KiB
C
976 lines
45 KiB
C
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*-
|
|
*
|
|
* Copyright (C) 2011 Colin Walters <walters@verbum.org>
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*
|
|
* Author: Colin Walters <walters@verbum.org>
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "ostree-core.h"
|
|
#include "ostree-types.h"
|
|
#include "ostree-async-progress.h"
|
|
#include "ostree-sepolicy.h"
|
|
#include "ostree-gpg-verify-result.h"
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define OSTREE_TYPE_REPO ostree_repo_get_type()
|
|
#define OSTREE_REPO(obj) \
|
|
(G_TYPE_CHECK_INSTANCE_CAST ((obj), OSTREE_TYPE_REPO, OstreeRepo))
|
|
#define OSTREE_IS_REPO(obj) \
|
|
(G_TYPE_CHECK_INSTANCE_TYPE ((obj), OSTREE_TYPE_REPO))
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_mode_from_string (const char *mode,
|
|
OstreeRepoMode *out_mode,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
GType ostree_repo_get_type (void);
|
|
|
|
_OSTREE_PUBLIC
|
|
OstreeRepo* ostree_repo_new (GFile *path);
|
|
|
|
_OSTREE_PUBLIC
|
|
OstreeRepo* ostree_repo_new_for_sysroot_path (GFile *repo_path,
|
|
GFile *sysroot_path);
|
|
|
|
_OSTREE_PUBLIC
|
|
OstreeRepo* ostree_repo_new_default (void);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_open (OstreeRepo *self,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_set_disable_fsync (OstreeRepo *self,
|
|
gboolean disable_fsync);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_get_disable_fsync (OstreeRepo *self);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_is_system (OstreeRepo *repo);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_is_writable (OstreeRepo *self,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_create (OstreeRepo *self,
|
|
OstreeRepoMode mode,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
GFile * ostree_repo_get_path (OstreeRepo *self);
|
|
|
|
_OSTREE_PUBLIC
|
|
OstreeRepoMode ostree_repo_get_mode (OstreeRepo *self);
|
|
|
|
_OSTREE_PUBLIC
|
|
GKeyFile * ostree_repo_get_config (OstreeRepo *self);
|
|
|
|
_OSTREE_PUBLIC
|
|
GKeyFile * ostree_repo_copy_config (OstreeRepo *self);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_remote_add (OstreeRepo *self,
|
|
const char *name,
|
|
const char *url,
|
|
GVariant *options,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_remote_delete (OstreeRepo *self,
|
|
const char *name,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
typedef enum {
|
|
OSTREE_REPO_REMOTE_CHANGE_ADD,
|
|
OSTREE_REPO_REMOTE_CHANGE_ADD_IF_NOT_EXISTS,
|
|
OSTREE_REPO_REMOTE_CHANGE_DELETE,
|
|
OSTREE_REPO_REMOTE_CHANGE_DELETE_IF_EXISTS
|
|
} OstreeRepoRemoteChange;
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_remote_change (OstreeRepo *self,
|
|
GFile *sysroot,
|
|
OstreeRepoRemoteChange changeop,
|
|
const char *name,
|
|
const char *url,
|
|
GVariant *options,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
char ** ostree_repo_remote_list (OstreeRepo *self,
|
|
guint *out_n_remotes);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_remote_get_url (OstreeRepo *self,
|
|
const char *name,
|
|
char **out_url,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_remote_get_gpg_verify (OstreeRepo *self,
|
|
const char *name,
|
|
gboolean *out_gpg_verify,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_remote_get_gpg_verify_summary (OstreeRepo *self,
|
|
const char *name,
|
|
gboolean *out_gpg_verify_summary,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_remote_gpg_import (OstreeRepo *self,
|
|
const char *name,
|
|
GInputStream *source_stream,
|
|
const char * const *key_ids,
|
|
guint *out_imported,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_remote_fetch_summary (OstreeRepo *self,
|
|
const char *name,
|
|
GBytes **out_summary,
|
|
GBytes **out_signatures,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
OstreeRepo * ostree_repo_get_parent (OstreeRepo *self);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_config (OstreeRepo *self,
|
|
GKeyFile *new_config,
|
|
GError **error);
|
|
|
|
/**
|
|
* OstreeRepoTransactionStats:
|
|
* @metadata_objects_total: The total number of metadata objects
|
|
* in the repository after this transaction has completed.
|
|
* @metadata_objects_written: The number of metadata objects that
|
|
* were written to the repository in this transaction.
|
|
* @content_objects_total: The total number of content objects
|
|
* in the repository after this transaction has completed.
|
|
* @content_objects_written: The number of content objects that
|
|
* were written to the repository in this transaction.
|
|
* @content_bytes_written: The amount of data added to the repository,
|
|
* in bytes, counting only content objects.
|
|
*
|
|
* A list of statistics for each transaction that may be
|
|
* interesting for reporting purposes.
|
|
*/
|
|
typedef struct _OstreeRepoTransactionStats OstreeRepoTransactionStats;
|
|
|
|
struct _OstreeRepoTransactionStats {
|
|
guint metadata_objects_total;
|
|
guint metadata_objects_written;
|
|
guint content_objects_total;
|
|
guint content_objects_written;
|
|
guint64 content_bytes_written;
|
|
|
|
guint64 padding1;
|
|
guint64 padding2;
|
|
guint64 padding3;
|
|
guint64 padding4;
|
|
};
|
|
|
|
_OSTREE_PUBLIC
|
|
GType ostree_repo_transaction_stats_get_type (void);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_scan_hardlinks (OstreeRepo *self,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_prepare_transaction (OstreeRepo *self,
|
|
gboolean *out_transaction_resume,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_commit_transaction (OstreeRepo *self,
|
|
OstreeRepoTransactionStats *out_stats,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_abort_transaction (OstreeRepo *self,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_transaction_set_refspec (OstreeRepo *self,
|
|
const char *refspec,
|
|
const char *checksum);
|
|
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_transaction_set_ref (OstreeRepo *self,
|
|
const char *remote,
|
|
const char *ref,
|
|
const char *checksum);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_set_ref_immediate (OstreeRepo *self,
|
|
const char *remote,
|
|
const char *ref,
|
|
const char *checksum,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_has_object (OstreeRepo *self,
|
|
OstreeObjectType objtype,
|
|
const char *checksum,
|
|
gboolean *out_have_object,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_metadata (OstreeRepo *self,
|
|
OstreeObjectType objtype,
|
|
const char *expected_checksum,
|
|
GVariant *object,
|
|
guchar **out_csum,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_write_metadata_async (OstreeRepo *self,
|
|
OstreeObjectType objtype,
|
|
const char *expected_checksum,
|
|
GVariant *object,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_metadata_finish (OstreeRepo *self,
|
|
GAsyncResult *result,
|
|
guchar **out_csum,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_content (OstreeRepo *self,
|
|
const char *expected_checksum,
|
|
GInputStream *object_input,
|
|
guint64 length,
|
|
guchar **out_csum,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_metadata_trusted (OstreeRepo *self,
|
|
OstreeObjectType objtype,
|
|
const char *checksum,
|
|
GVariant *variant,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_metadata_stream_trusted (OstreeRepo *self,
|
|
OstreeObjectType objtype,
|
|
const char *checksum,
|
|
GInputStream *object_input,
|
|
guint64 length,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_content_trusted (OstreeRepo *self,
|
|
const char *checksum,
|
|
GInputStream *object_input,
|
|
guint64 length,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_write_content_async (OstreeRepo *self,
|
|
const char *expected_checksum,
|
|
GInputStream *object,
|
|
guint64 length,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_content_finish (OstreeRepo *self,
|
|
GAsyncResult *result,
|
|
guchar **out_csum,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_resolve_rev (OstreeRepo *self,
|
|
const char *refspec,
|
|
gboolean allow_noent,
|
|
char **out_rev,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_list_refs (OstreeRepo *self,
|
|
const char *refspec_prefix,
|
|
GHashTable **out_all_refs,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_remote_list_refs (OstreeRepo *self,
|
|
const char *remote_name,
|
|
GHashTable **out_all_refs,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_load_variant (OstreeRepo *self,
|
|
OstreeObjectType objtype,
|
|
const char *sha256,
|
|
GVariant **out_variant,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_load_variant_if_exists (OstreeRepo *self,
|
|
OstreeObjectType objtype,
|
|
const char *sha256,
|
|
GVariant **out_variant,
|
|
GError **error);
|
|
|
|
typedef enum {
|
|
OSTREE_REPO_COMMIT_STATE_PARTIAL = (1 << 0),
|
|
} OstreeRepoCommitState;
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_load_commit (OstreeRepo *self,
|
|
const char *checksum,
|
|
GVariant **out_commit,
|
|
OstreeRepoCommitState *out_state,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_load_file (OstreeRepo *self,
|
|
const char *checksum,
|
|
GInputStream **out_input,
|
|
GFileInfo **out_file_info,
|
|
GVariant **out_xattrs,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_load_object_stream (OstreeRepo *self,
|
|
OstreeObjectType objtype,
|
|
const char *checksum,
|
|
GInputStream **out_input,
|
|
guint64 *out_size,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_query_object_storage_size (OstreeRepo *self,
|
|
OstreeObjectType objtype,
|
|
const char *sha256,
|
|
guint64 *out_size,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_import_object_from (OstreeRepo *self,
|
|
OstreeRepo *source,
|
|
OstreeObjectType objtype,
|
|
const char *checksum,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_delete_object (OstreeRepo *self,
|
|
OstreeObjectType objtype,
|
|
const char *sha256,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
/**
|
|
* OstreeRepoCommitFilterResult:
|
|
* @OSTREE_REPO_COMMIT_FILTER_ALLOW: Do commit this object
|
|
* @OSTREE_REPO_COMMIT_FILTER_SKIP: Ignore this object
|
|
*/
|
|
typedef enum {
|
|
OSTREE_REPO_COMMIT_FILTER_ALLOW,
|
|
OSTREE_REPO_COMMIT_FILTER_SKIP
|
|
} OstreeRepoCommitFilterResult;
|
|
|
|
/**
|
|
* OstreeRepoCommitFilter:
|
|
* @repo: Repo
|
|
* @path: Path to file
|
|
* @file_info: File information
|
|
* @user_data: User data
|
|
*
|
|
* Returns: #OstreeRepoCommitFilterResult saying whether or not to commit this file
|
|
*/
|
|
typedef OstreeRepoCommitFilterResult (*OstreeRepoCommitFilter) (OstreeRepo *repo,
|
|
const char *path,
|
|
GFileInfo *file_info,
|
|
gpointer user_data);
|
|
|
|
/**
|
|
* OstreeRepoCommitModifierFlags:
|
|
* @OSTREE_REPO_COMMIT_MODIFIER_FLAGS_NONE: No special flags
|
|
* @OSTREE_REPO_COMMIT_MODIFIER_FLAGS_SKIP_XATTRS: Do not process extended attributes
|
|
* @OSTREE_REPO_COMMIT_MODIFIER_FLAGS_GENERATE_SIZES: Generate size information.
|
|
*/
|
|
typedef enum {
|
|
OSTREE_REPO_COMMIT_MODIFIER_FLAGS_NONE = 0,
|
|
OSTREE_REPO_COMMIT_MODIFIER_FLAGS_SKIP_XATTRS = (1 << 0),
|
|
OSTREE_REPO_COMMIT_MODIFIER_FLAGS_GENERATE_SIZES = (1 << 1)
|
|
} OstreeRepoCommitModifierFlags;
|
|
|
|
/**
|
|
* OstreeRepoCommitModifier:
|
|
*
|
|
* A structure allowing control over commits.
|
|
*/
|
|
typedef struct OstreeRepoCommitModifier OstreeRepoCommitModifier;
|
|
|
|
_OSTREE_PUBLIC
|
|
OstreeRepoCommitModifier *ostree_repo_commit_modifier_new (OstreeRepoCommitModifierFlags flags,
|
|
OstreeRepoCommitFilter commit_filter,
|
|
gpointer user_data,
|
|
GDestroyNotify destroy_notify);
|
|
|
|
_OSTREE_PUBLIC
|
|
GType ostree_repo_commit_modifier_get_type (void);
|
|
|
|
typedef GVariant *(*OstreeRepoCommitModifierXattrCallback) (OstreeRepo *repo,
|
|
const char *path,
|
|
GFileInfo *file_info,
|
|
gpointer user_data);
|
|
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_commit_modifier_set_xattr_callback (OstreeRepoCommitModifier *modifier,
|
|
OstreeRepoCommitModifierXattrCallback callback,
|
|
GDestroyNotify destroy,
|
|
gpointer user_data);
|
|
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_commit_modifier_set_sepolicy (OstreeRepoCommitModifier *modifier,
|
|
OstreeSePolicy *sepolicy);
|
|
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_commit_modifier_set_devino_cache (OstreeRepoCommitModifier *modifier,
|
|
OstreeRepoDevInoCache *cache);
|
|
|
|
_OSTREE_PUBLIC
|
|
OstreeRepoCommitModifier *ostree_repo_commit_modifier_ref (OstreeRepoCommitModifier *modifier);
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_commit_modifier_unref (OstreeRepoCommitModifier *modifier);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_directory_to_mtree (OstreeRepo *self,
|
|
GFile *dir,
|
|
OstreeMutableTree *mtree,
|
|
OstreeRepoCommitModifier *modifier,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_dfd_to_mtree (OstreeRepo *self,
|
|
int dfd,
|
|
const char *path,
|
|
OstreeMutableTree *mtree,
|
|
OstreeRepoCommitModifier *modifier,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_archive_to_mtree (OstreeRepo *self,
|
|
GFile *archive,
|
|
OstreeMutableTree *mtree,
|
|
OstreeRepoCommitModifier *modifier,
|
|
gboolean autocreate_parents,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
/**
|
|
* OstreeRepoImportArchiveOptions:
|
|
*
|
|
* 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().
|
|
*/
|
|
typedef struct {
|
|
guint ignore_unsupported_content : 1;
|
|
guint autocreate_parents : 1;
|
|
guint reserved : 30;
|
|
|
|
guint unused_uint[8];
|
|
gpointer unused_ptrs[8];
|
|
} OstreeRepoImportArchiveOptions;
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_import_archive_to_mtree (OstreeRepo *self,
|
|
OstreeRepoImportArchiveOptions *opts,
|
|
void *archive, /* Really struct archive * */
|
|
OstreeMutableTree *mtree,
|
|
OstreeRepoCommitModifier *modifier,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
/**
|
|
* OstreeRepoExportArchiveOptions:
|
|
*
|
|
* 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().
|
|
*/
|
|
typedef struct {
|
|
guint disable_xattrs : 1;
|
|
guint reserved : 31;
|
|
|
|
guint64 timestamp_secs;
|
|
|
|
guint unused_uint[8];
|
|
gpointer unused_ptrs[8];
|
|
} OstreeRepoExportArchiveOptions;
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_export_tree_to_archive (OstreeRepo *self,
|
|
OstreeRepoExportArchiveOptions *opts,
|
|
OstreeRepoFile *root,
|
|
void *archive, /* Really struct archive * */
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_mtree (OstreeRepo *self,
|
|
OstreeMutableTree *mtree,
|
|
GFile **out_file,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_commit (OstreeRepo *self,
|
|
const char *parent,
|
|
const char *subject,
|
|
const char *body,
|
|
GVariant *metadata,
|
|
OstreeRepoFile *root,
|
|
char **out_commit,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_commit_with_time (OstreeRepo *self,
|
|
const char *parent,
|
|
const char *subject,
|
|
const char *body,
|
|
GVariant *metadata,
|
|
OstreeRepoFile *root,
|
|
guint64 time,
|
|
char **out_commit,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_read_commit_detached_metadata (OstreeRepo *self,
|
|
const char *checksum,
|
|
GVariant **out_metadata,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_write_commit_detached_metadata (OstreeRepo *self,
|
|
const char *checksum,
|
|
GVariant *metadata,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
/**
|
|
* OstreeRepoCheckoutMode:
|
|
* @OSTREE_REPO_CHECKOUT_MODE_NONE: No special options
|
|
* @OSTREE_REPO_CHECKOUT_MODE_USER: Ignore uid/gid of files
|
|
*/
|
|
typedef enum {
|
|
OSTREE_REPO_CHECKOUT_MODE_NONE = 0,
|
|
OSTREE_REPO_CHECKOUT_MODE_USER = 1
|
|
} OstreeRepoCheckoutMode;
|
|
|
|
/**
|
|
* OstreeRepoCheckoutOverwriteMode:
|
|
* @OSTREE_REPO_CHECKOUT_OVERWRITE_NONE: No special options
|
|
* @OSTREE_REPO_CHECKOUT_OVERWRITE_UNION_FILES: When layering checkouts, overwrite earlier files, but keep earlier directories
|
|
*/
|
|
typedef enum {
|
|
OSTREE_REPO_CHECKOUT_OVERWRITE_NONE = 0,
|
|
OSTREE_REPO_CHECKOUT_OVERWRITE_UNION_FILES = 1
|
|
} OstreeRepoCheckoutOverwriteMode;
|
|
|
|
_OSTREE_PUBLIC gboolean
|
|
ostree_repo_checkout_tree (OstreeRepo *self,
|
|
OstreeRepoCheckoutMode mode,
|
|
OstreeRepoCheckoutOverwriteMode overwrite_mode,
|
|
GFile *destination,
|
|
OstreeRepoFile *source,
|
|
GFileInfo *source_info,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
/**
|
|
* OstreeRepoCheckoutOptions:
|
|
*
|
|
* 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().
|
|
*/
|
|
typedef struct {
|
|
OstreeRepoCheckoutMode mode;
|
|
OstreeRepoCheckoutOverwriteMode overwrite_mode;
|
|
|
|
guint enable_uncompressed_cache : 1;
|
|
guint disable_fsync : 1;
|
|
guint process_whiteouts : 1;
|
|
guint reserved : 29;
|
|
|
|
const char *subpath;
|
|
|
|
OstreeRepoDevInoCache *devino_to_csum_cache;
|
|
|
|
guint unused_uints[6];
|
|
gpointer unused_ptrs[7];
|
|
} OstreeRepoCheckoutOptions;
|
|
|
|
_OSTREE_PUBLIC
|
|
GType ostree_repo_devino_cache_get_type (void);
|
|
_OSTREE_PUBLIC
|
|
OstreeRepoDevInoCache *ostree_repo_devino_cache_new (void);
|
|
_OSTREE_PUBLIC
|
|
OstreeRepoDevInoCache * ostree_repo_devino_cache_ref (OstreeRepoDevInoCache *cache);
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_devino_cache_unref (OstreeRepoDevInoCache *cache);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_checkout_tree_at (OstreeRepo *self,
|
|
OstreeRepoCheckoutOptions *options,
|
|
int destination_dfd,
|
|
const char *destination_path,
|
|
const char *commit,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_checkout_gc (OstreeRepo *self,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_read_commit (OstreeRepo *self,
|
|
const char *ref,
|
|
GFile **out_root,
|
|
char **out_commit,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
/**
|
|
* OstreeRepoListObjectsFlags:
|
|
* @OSTREE_REPO_LIST_OBJECTS_LOOSE: List only loose (plain file) objects
|
|
* @OSTREE_REPO_LIST_OBJECTS_PACKED: List only packed (compacted into blobs) objects
|
|
* @OSTREE_REPO_LIST_OBJECTS_ALL: List all objects
|
|
*/
|
|
typedef enum {
|
|
OSTREE_REPO_LIST_OBJECTS_LOOSE = (1 << 0),
|
|
OSTREE_REPO_LIST_OBJECTS_PACKED = (1 << 1),
|
|
OSTREE_REPO_LIST_OBJECTS_ALL = (1 << 2)
|
|
} OstreeRepoListObjectsFlags;
|
|
|
|
/**
|
|
* OSTREE_REPO_LIST_OBJECTS_VARIANT_TYPE:
|
|
*
|
|
* b - %TRUE if object is available "loose"
|
|
* as - List of pack file checksums in which this object appears
|
|
*/
|
|
#define OSTREE_REPO_LIST_OBJECTS_VARIANT_TYPE (G_VARIANT_TYPE ("(bas)")
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_list_objects (OstreeRepo *self,
|
|
OstreeRepoListObjectsFlags flags,
|
|
GHashTable **out_objects,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_list_commit_objects_starting_with ( OstreeRepo *self,
|
|
const char *start,
|
|
GHashTable **out_commits,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_list_static_delta_names (OstreeRepo *self,
|
|
GPtrArray **out_deltas,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
/**
|
|
* OstreeStaticDeltaGenerateOpt:
|
|
* @OSTREE_STATIC_DELTA_GENERATE_OPT_LOWLATENCY: Optimize for speed of delta creation over space
|
|
* @OSTREE_STATIC_DELTA_GENERATE_OPT_MAJOR: Optimize for delta size (may be very slow)
|
|
*
|
|
* Parameters controlling optimization of static deltas.
|
|
*/
|
|
typedef enum {
|
|
OSTREE_STATIC_DELTA_GENERATE_OPT_LOWLATENCY,
|
|
OSTREE_STATIC_DELTA_GENERATE_OPT_MAJOR
|
|
} OstreeStaticDeltaGenerateOpt;
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_static_delta_generate (OstreeRepo *self,
|
|
OstreeStaticDeltaGenerateOpt opt,
|
|
const char *from,
|
|
const char *to,
|
|
GVariant *metadata,
|
|
GVariant *params,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_static_delta_execute_offline (OstreeRepo *self,
|
|
GFile *dir_or_file,
|
|
gboolean skip_validation,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
GHashTable *ostree_repo_traverse_new_reachable (void);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_traverse_commit (OstreeRepo *repo,
|
|
const char *commit_checksum,
|
|
int maxdepth,
|
|
GHashTable **out_reachable,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_traverse_commit_union (OstreeRepo *repo,
|
|
const char *commit_checksum,
|
|
int maxdepth,
|
|
GHashTable *inout_reachable,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
struct _OstreeRepoCommitTraverseIter {
|
|
gboolean initialized;
|
|
gpointer dummy[10];
|
|
char dummy_checksum_data[65*2];
|
|
};
|
|
|
|
typedef struct _OstreeRepoCommitTraverseIter OstreeRepoCommitTraverseIter;
|
|
|
|
typedef enum {
|
|
OSTREE_REPO_COMMIT_TRAVERSE_FLAG_NONE = (1 << 0)
|
|
} OstreeRepoCommitTraverseFlags;
|
|
|
|
_OSTREE_PUBLIC gboolean
|
|
ostree_repo_commit_traverse_iter_init_commit (OstreeRepoCommitTraverseIter *iter,
|
|
OstreeRepo *repo,
|
|
GVariant *commit,
|
|
OstreeRepoCommitTraverseFlags flags,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC gboolean
|
|
ostree_repo_commit_traverse_iter_init_dirtree (OstreeRepoCommitTraverseIter *iter,
|
|
OstreeRepo *repo,
|
|
GVariant *dirtree,
|
|
OstreeRepoCommitTraverseFlags flags,
|
|
GError **error);
|
|
|
|
typedef enum {
|
|
OSTREE_REPO_COMMIT_ITER_RESULT_ERROR,
|
|
OSTREE_REPO_COMMIT_ITER_RESULT_END,
|
|
OSTREE_REPO_COMMIT_ITER_RESULT_FILE,
|
|
OSTREE_REPO_COMMIT_ITER_RESULT_DIR
|
|
} OstreeRepoCommitIterResult;
|
|
|
|
_OSTREE_PUBLIC
|
|
OstreeRepoCommitIterResult ostree_repo_commit_traverse_iter_next (OstreeRepoCommitTraverseIter *iter,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_commit_traverse_iter_get_file (OstreeRepoCommitTraverseIter *iter,
|
|
char **out_name,
|
|
char **out_checksum);
|
|
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_commit_traverse_iter_get_dir (OstreeRepoCommitTraverseIter *iter,
|
|
char **out_name,
|
|
char **out_content_checksum,
|
|
char **out_meta_checksum);
|
|
|
|
_OSTREE_PUBLIC void
|
|
ostree_repo_commit_traverse_iter_clear (OstreeRepoCommitTraverseIter *iter);
|
|
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_commit_traverse_iter_cleanup (void *p);
|
|
|
|
#define ostree_cleanup_repo_commit_traverse_iter __attribute__ ((cleanup(ostree_repo_commit_traverse_iter_cleanup)))
|
|
|
|
/**
|
|
* OstreeRepoPruneFlags:
|
|
* @OSTREE_REPO_PRUNE_FLAGS_NONE: No special options for pruning
|
|
* @OSTREE_REPO_PRUNE_FLAGS_NO_PRUNE: Don't actually delete objects
|
|
* @OSTREE_REPO_PRUNE_FLAGS_REFS_ONLY: Do not traverse individual commit objects, only follow refs
|
|
*/
|
|
typedef enum {
|
|
OSTREE_REPO_PRUNE_FLAGS_NONE,
|
|
OSTREE_REPO_PRUNE_FLAGS_NO_PRUNE,
|
|
OSTREE_REPO_PRUNE_FLAGS_REFS_ONLY
|
|
} OstreeRepoPruneFlags;
|
|
|
|
_OSTREE_PUBLIC gboolean
|
|
ostree_repo_prune_static_deltas (OstreeRepo *self, const char *commit,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_prune (OstreeRepo *self,
|
|
OstreeRepoPruneFlags flags,
|
|
gint depth,
|
|
gint *out_objects_total,
|
|
gint *out_objects_pruned,
|
|
guint64 *out_pruned_object_size_total,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
/**
|
|
* OstreeRepoPullFlags:
|
|
* @OSTREE_REPO_PULL_FLAGS_NONE: No special options for pull
|
|
* @OSTREE_REPO_PULL_FLAGS_MIRROR: Write out refs suitable for mirrors
|
|
* @OSTREE_REPO_PULL_FLAGS_COMMIT_ONLY: Fetch only the commit metadata
|
|
*/
|
|
typedef enum {
|
|
OSTREE_REPO_PULL_FLAGS_NONE,
|
|
OSTREE_REPO_PULL_FLAGS_MIRROR = (1 << 0),
|
|
OSTREE_REPO_PULL_FLAGS_COMMIT_ONLY = (1 << 1)
|
|
} OstreeRepoPullFlags;
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_pull (OstreeRepo *self,
|
|
const char *remote_name,
|
|
char **refs_to_fetch,
|
|
OstreeRepoPullFlags flags,
|
|
OstreeAsyncProgress *progress,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC gboolean
|
|
ostree_repo_pull_one_dir (OstreeRepo *self,
|
|
const char *remote_name,
|
|
const char *dir_to_pull,
|
|
char **refs_to_fetch,
|
|
OstreeRepoPullFlags flags,
|
|
OstreeAsyncProgress *progress,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_pull_with_options (OstreeRepo *self,
|
|
const char *remote_name,
|
|
GVariant *options,
|
|
OstreeAsyncProgress *progress,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
void ostree_repo_pull_default_console_progress_changed (OstreeAsyncProgress *progress,
|
|
gpointer user_data);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_sign_commit (OstreeRepo *self,
|
|
const gchar *commit_checksum,
|
|
const gchar *key_id,
|
|
const gchar *homedir,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_sign_delta (OstreeRepo *self,
|
|
const gchar *from_commit,
|
|
const gchar *to_commit,
|
|
const gchar *key_id,
|
|
const gchar *homedir,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC gboolean
|
|
ostree_repo_add_gpg_signature_summary (OstreeRepo *self,
|
|
const gchar **key_id,
|
|
const gchar *homedir,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_append_gpg_signature (OstreeRepo *self,
|
|
const gchar *commit_checksum,
|
|
GBytes *signature_bytes,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_verify_commit (OstreeRepo *self,
|
|
const gchar *commit_checksum,
|
|
GFile *keyringdir,
|
|
GFile *extra_keyring,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
OstreeGpgVerifyResult * ostree_repo_verify_commit_ext (OstreeRepo *self,
|
|
const gchar *commit_checksum,
|
|
GFile *keyringdir,
|
|
GFile *extra_keyring,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
OstreeGpgVerifyResult * ostree_repo_verify_summary (OstreeRepo *self,
|
|
const char *remote_name,
|
|
GBytes *summary,
|
|
GBytes *signatures,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
_OSTREE_PUBLIC
|
|
gboolean ostree_repo_regenerate_summary (OstreeRepo *self,
|
|
GVariant *additional_metadata,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
|
|
G_END_DECLS
|