293 lines
12 KiB
C
293 lines
12 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 <gio/gio.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/**
|
|
* OSTREE_MAX_METADATA_SIZE:
|
|
*
|
|
* Maximum permitted size in bytes of metadata objects.
|
|
*/
|
|
#define OSTREE_MAX_METADATA_SIZE (1 << 26)
|
|
|
|
/**
|
|
* OSTREE_MAX_RECURSION:
|
|
*
|
|
* Maximum depth of metadata.
|
|
*/
|
|
#define OSTREE_MAX_RECURSION (256)
|
|
|
|
/**
|
|
* OstreeObjectType:
|
|
* @OSTREE_OBJECT_TYPE_FILE: Content; regular file, symbolic link
|
|
* @OSTREE_OBJECT_TYPE_DIR_TREE: List of children (trees or files), and metadata
|
|
* @OSTREE_OBJECT_TYPE_DIR_META: Directory metadata
|
|
* @OSTREE_OBJECT_TYPE_COMMIT: Toplevel object, refers to tree and dirmeta for root
|
|
*
|
|
* Enumeration for core object types; %OSTREE_OBJECT_TYPE_FILE is for
|
|
* content, the other types are metadata.
|
|
*/
|
|
typedef enum {
|
|
OSTREE_OBJECT_TYPE_FILE = 1, /* .file */
|
|
OSTREE_OBJECT_TYPE_DIR_TREE = 2, /* .dirtree */
|
|
OSTREE_OBJECT_TYPE_DIR_META = 3, /* .dirmeta */
|
|
OSTREE_OBJECT_TYPE_COMMIT = 4 /* .commit */
|
|
} OstreeObjectType;
|
|
|
|
/**
|
|
* OSTREE_OBJECT_TYPE_IS_META:
|
|
* @t: An #OstreeObjectType
|
|
*
|
|
* Returns: %TRUE if object type is metadata
|
|
*/
|
|
#define OSTREE_OBJECT_TYPE_IS_META(t) (t >= 2 && t <= 4)
|
|
|
|
/**
|
|
* OSTREE_OBJECT_TYPE_LAST:
|
|
*
|
|
* Last valid object type; use this to validate ranges.
|
|
*/
|
|
#define OSTREE_OBJECT_TYPE_LAST OSTREE_OBJECT_TYPE_COMMIT
|
|
|
|
/**
|
|
* OSTREE_DIRMETA_GVARIANT_FORMAT:
|
|
*
|
|
* u - uid
|
|
* u - gid
|
|
* u - mode
|
|
* a(ayay) - xattrs
|
|
*/
|
|
#define OSTREE_DIRMETA_GVARIANT_FORMAT G_VARIANT_TYPE ("(uuua(ayay))")
|
|
|
|
/**
|
|
* OSTREE_TREE_GVARIANT_FORMAT:
|
|
*
|
|
* a(say) - array of (filename, checksum) for files
|
|
* a(sayay) - array of (dirname, tree_checksum, meta_checksum) for directories
|
|
*/
|
|
#define OSTREE_TREE_GVARIANT_FORMAT G_VARIANT_TYPE ("(a(say)a(sayay))")
|
|
|
|
/**
|
|
* OSTREE_COMMIT_GVARIANT_FORMAT:
|
|
*
|
|
* a{sv} - Metadata
|
|
* ay - parent checksum (empty string for initial)
|
|
* a(say) - Related objects
|
|
* s - subject
|
|
* s - body
|
|
* t - Timestamp in seconds since the epoch (UTC)
|
|
* ay - Root tree contents
|
|
* ay - Root tree metadata
|
|
*/
|
|
#define OSTREE_COMMIT_GVARIANT_FORMAT G_VARIANT_TYPE ("(a{sv}aya(say)sstayay)")
|
|
|
|
const GVariantType *ostree_metadata_variant_type (OstreeObjectType objtype);
|
|
|
|
gboolean ostree_validate_checksum_string (const char *sha256,
|
|
GError **error);
|
|
|
|
guchar *ostree_checksum_to_bytes (const char *checksum);
|
|
GVariant *ostree_checksum_to_bytes_v (const char *checksum);
|
|
|
|
char * ostree_checksum_from_bytes (const guchar *csum);
|
|
char * ostree_checksum_from_bytes_v (GVariant *csum_v);
|
|
|
|
void ostree_checksum_inplace_from_bytes (const guchar *csum,
|
|
char *buf);
|
|
|
|
void ostree_checksum_inplace_to_bytes (const char *checksum,
|
|
guchar *buf);
|
|
|
|
const guchar *ostree_checksum_bytes_peek (GVariant *bytes);
|
|
|
|
int ostree_cmp_checksum_bytes (const guchar *a, const guchar *b);
|
|
|
|
gboolean ostree_validate_rev (const char *rev, GError **error);
|
|
|
|
gboolean ostree_parse_refspec (const char *refspec,
|
|
char **out_remote,
|
|
char **out_ref,
|
|
GError **error);
|
|
|
|
void ostree_checksum_update_meta (GChecksum *checksum, GFileInfo *file_info, GVariant *xattrs);
|
|
|
|
const char * ostree_object_type_to_string (OstreeObjectType objtype);
|
|
|
|
OstreeObjectType ostree_object_type_from_string (const char *str);
|
|
|
|
guint ostree_hash_object_name (gconstpointer a);
|
|
|
|
GVariant *ostree_object_name_serialize (const char *checksum,
|
|
OstreeObjectType objtype);
|
|
|
|
void ostree_object_name_deserialize (GVariant *variant,
|
|
const char **out_checksum,
|
|
OstreeObjectType *out_objtype);
|
|
|
|
char * ostree_object_to_string (const char *checksum,
|
|
OstreeObjectType objtype);
|
|
|
|
void ostree_object_from_string (const char *str,
|
|
gchar **out_checksum,
|
|
OstreeObjectType *out_objtype);
|
|
|
|
char *ostree_get_relative_object_path (const char *checksum,
|
|
OstreeObjectType type,
|
|
gboolean compressed);
|
|
|
|
gboolean ostree_get_xattrs_for_file (GFile *f,
|
|
GVariant **out_xattrs,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
gboolean ostree_set_xattrs (GFile *f, GVariant *xattrs,
|
|
GCancellable *cancellable, GError **error);
|
|
|
|
gboolean ostree_map_metadata_file (GFile *file,
|
|
OstreeObjectType expected_type,
|
|
GVariant **out_variant,
|
|
GError **error);
|
|
|
|
GVariant *ostree_file_header_new (GFileInfo *file_info,
|
|
GVariant *xattrs);
|
|
|
|
gboolean ostree_file_header_parse (GVariant *metadata,
|
|
GFileInfo **out_file_info,
|
|
GVariant **out_xattrs,
|
|
GError **error);
|
|
gboolean ostree_zlib_file_header_parse (GVariant *metadata,
|
|
GFileInfo **out_file_info,
|
|
GVariant **out_xattrs,
|
|
GError **error);
|
|
|
|
gboolean
|
|
ostree_content_stream_parse (gboolean compressed,
|
|
GInputStream *input,
|
|
guint64 input_length,
|
|
gboolean trusted,
|
|
GInputStream **out_input,
|
|
GFileInfo **out_file_info,
|
|
GVariant **out_xattrs,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
gboolean ostree_content_file_parse (gboolean compressed,
|
|
GFile *content_path,
|
|
gboolean trusted,
|
|
GInputStream **out_input,
|
|
GFileInfo **out_file_info,
|
|
GVariant **out_xattrs,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
gboolean ostree_raw_file_to_content_stream (GInputStream *input,
|
|
GFileInfo *file_info,
|
|
GVariant *xattrs,
|
|
GInputStream **out_input,
|
|
guint64 *out_length,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
gboolean ostree_checksum_file_from_input (GFileInfo *file_info,
|
|
GVariant *xattrs,
|
|
GInputStream *in,
|
|
OstreeObjectType objtype,
|
|
guchar **out_csum,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
gboolean ostree_checksum_file (GFile *f,
|
|
OstreeObjectType objtype,
|
|
guchar **out_csum,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
void ostree_checksum_file_async (GFile *f,
|
|
OstreeObjectType objtype,
|
|
int io_priority,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
|
|
gboolean ostree_checksum_file_async_finish (GFile *f,
|
|
GAsyncResult *result,
|
|
guchar **out_csum,
|
|
GError **error);
|
|
|
|
GVariant *ostree_create_directory_metadata (GFileInfo *dir_info,
|
|
GVariant *xattrs);
|
|
|
|
gboolean ostree_create_file_from_input (GFile *dest_file,
|
|
GFileInfo *finfo,
|
|
GVariant *xattrs,
|
|
GInputStream *input,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
gboolean ostree_create_temp_file_from_input (GFile *dir,
|
|
const char *prefix,
|
|
const char *suffix,
|
|
GFileInfo *finfo,
|
|
GVariant *xattrs,
|
|
GInputStream *input,
|
|
GFile **out_file,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
gboolean ostree_create_temp_dir (GFile *dir,
|
|
const char *prefix,
|
|
const char *suffix,
|
|
GFile **out_file,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
/** VALIDATION **/
|
|
|
|
gboolean ostree_validate_structureof_objtype (guchar objtype,
|
|
GError **error);
|
|
|
|
gboolean ostree_validate_structureof_csum_v (GVariant *checksum,
|
|
GError **error);
|
|
|
|
gboolean ostree_validate_structureof_checksum_string (const char *checksum,
|
|
GError **error);
|
|
|
|
gboolean ostree_validate_structureof_file_mode (guint32 mode,
|
|
GError **error);
|
|
|
|
gboolean ostree_validate_structureof_commit (GVariant *commit,
|
|
GError **error);
|
|
|
|
gboolean ostree_validate_structureof_dirtree (GVariant *dirtree,
|
|
GError **error);
|
|
|
|
gboolean ostree_validate_structureof_dirmeta (GVariant *dirmeta,
|
|
GError **error);
|
|
|
|
gchar * ostree_commit_get_parent (GVariant *commit_variant);
|
|
|
|
G_END_DECLS
|