object-store.hon commit t4205: sort log output in a hash-independent way (2a73022)
   1#ifndef OBJECT_STORE_H
   2#define OBJECT_STORE_H
   3
   4#include "oidmap.h"
   5
   6struct alternate_object_database {
   7        struct alternate_object_database *next;
   8
   9        /* see alt_scratch_buf() */
  10        struct strbuf scratch;
  11        size_t base_len;
  12
  13        /*
  14         * Used to store the results of readdir(3) calls when searching
  15         * for unique abbreviated hashes.  This cache is never
  16         * invalidated, thus it's racy and not necessarily accurate.
  17         * That's fine for its purpose; don't use it for tasks requiring
  18         * greater accuracy!
  19         */
  20        char loose_objects_subdir_seen[256];
  21        struct oid_array loose_objects_cache;
  22
  23        /*
  24         * Path to the alternative object store. If this is a relative path,
  25         * it is relative to the current working directory.
  26         */
  27        char path[FLEX_ARRAY];
  28};
  29void prepare_alt_odb(struct repository *r);
  30char *compute_alternate_path(const char *path, struct strbuf *err);
  31typedef int alt_odb_fn(struct alternate_object_database *, void *);
  32int foreach_alt_odb(alt_odb_fn, void*);
  33
  34/*
  35 * Allocate a "struct alternate_object_database" but do _not_ actually
  36 * add it to the list of alternates.
  37 */
  38struct alternate_object_database *alloc_alt_odb(const char *dir);
  39
  40/*
  41 * Add the directory to the on-disk alternates file; the new entry will also
  42 * take effect in the current process.
  43 */
  44void add_to_alternates_file(const char *dir);
  45
  46/*
  47 * Add the directory to the in-memory list of alternates (along with any
  48 * recursive alternates it points to), but do not modify the on-disk alternates
  49 * file.
  50 */
  51void add_to_alternates_memory(const char *dir);
  52
  53/*
  54 * Returns a scratch strbuf pre-filled with the alternate object directory,
  55 * including a trailing slash, which can be used to access paths in the
  56 * alternate. Always use this over direct access to alt->scratch, as it
  57 * cleans up any previous use of the scratch buffer.
  58 */
  59struct strbuf *alt_scratch_buf(struct alternate_object_database *alt);
  60
  61struct packed_git {
  62        struct packed_git *next;
  63        struct list_head mru;
  64        struct pack_window *windows;
  65        off_t pack_size;
  66        const void *index_data;
  67        size_t index_size;
  68        uint32_t num_objects;
  69        uint32_t num_bad_objects;
  70        unsigned char *bad_object_sha1;
  71        int index_version;
  72        time_t mtime;
  73        int pack_fd;
  74        unsigned pack_local:1,
  75                 pack_keep:1,
  76                 freshened:1,
  77                 do_not_close:1,
  78                 pack_promisor:1;
  79        unsigned char sha1[20];
  80        struct revindex_entry *revindex;
  81        /* something like ".git/objects/pack/xxxxx.pack" */
  82        char pack_name[FLEX_ARRAY]; /* more */
  83};
  84
  85struct raw_object_store {
  86        /*
  87         * Path to the repository's object store.
  88         * Cannot be NULL after initialization.
  89         */
  90        char *objectdir;
  91
  92        /* Path to extra alternate object database if not NULL */
  93        char *alternate_db;
  94
  95        struct alternate_object_database *alt_odb_list;
  96        struct alternate_object_database **alt_odb_tail;
  97
  98        /*
  99         * Objects that should be substituted by other objects
 100         * (see git-replace(1)).
 101         */
 102        struct oidmap *replace_map;
 103
 104        /*
 105         * private data
 106         *
 107         * should only be accessed directly by packfile.c
 108         */
 109
 110        struct packed_git *packed_git;
 111        /* A most-recently-used ordered version of the packed_git list. */
 112        struct list_head packed_git_mru;
 113
 114        /*
 115         * A fast, rough count of the number of objects in the repository.
 116         * These two fields are not meant for direct access. Use
 117         * approximate_object_count() instead.
 118         */
 119        unsigned long approximate_object_count;
 120        unsigned approximate_object_count_valid : 1;
 121
 122        /*
 123         * Whether packed_git has already been populated with this repository's
 124         * packs.
 125         */
 126        unsigned packed_git_initialized : 1;
 127};
 128
 129struct raw_object_store *raw_object_store_new(void);
 130void raw_object_store_clear(struct raw_object_store *o);
 131
 132/*
 133 * Put in `buf` the name of the file in the local object database that
 134 * would be used to store a loose object with the specified sha1.
 135 */
 136void sha1_file_name(struct repository *r, struct strbuf *buf, const unsigned char *sha1);
 137
 138void *map_sha1_file(struct repository *r, const unsigned char *sha1, unsigned long *size);
 139
 140#endif /* OBJECT_STORE_H */