connected.hon commit t1406: make hash-size independent (b1484ca)
   1#ifndef CONNECTED_H
   2#define CONNECTED_H
   3
   4struct object_id;
   5struct transport;
   6
   7/*
   8 * Take callback data, and return next object name in the buffer.
   9 * When called after returning the name for the last object, return -1
  10 * to signal EOF, otherwise return 0.
  11 */
  12typedef int (*oid_iterate_fn)(void *, struct object_id *oid);
  13
  14/*
  15 * Named-arguments struct for check_connected. All arguments are
  16 * optional, and can be left to defaults as set by CHECK_CONNECTED_INIT.
  17 */
  18struct check_connected_options {
  19        /* Avoid printing any errors to stderr. */
  20        int quiet;
  21
  22        /* --shallow-file to pass to rev-list sub-process */
  23        const char *shallow_file;
  24
  25        /* Transport whose objects we are checking, if available. */
  26        struct transport *transport;
  27
  28        /*
  29         * If non-zero, send error messages to this descriptor rather
  30         * than stderr. The descriptor is closed before check_connected
  31         * returns.
  32         */
  33        int err_fd;
  34
  35        /* If non-zero, show progress as we traverse the objects. */
  36        int progress;
  37
  38        /*
  39         * Insert these variables into the environment of the child process.
  40         */
  41        const char **env;
  42
  43        /*
  44         * If non-zero, check the ancestry chain completely, not stopping at
  45         * any existing ref. This is necessary when deepening existing refs
  46         * during a fetch.
  47         */
  48        unsigned is_deepening_fetch : 1;
  49};
  50
  51#define CHECK_CONNECTED_INIT { 0 }
  52
  53/*
  54 * Make sure that our object store has all the commits necessary to
  55 * connect the ancestry chain to some of our existing refs, and all
  56 * the trees and blobs that these commits use.
  57 *
  58 * Return 0 if Ok, non zero otherwise (i.e. some missing objects)
  59 *
  60 * If "opt" is NULL, behaves as if CHECK_CONNECTED_INIT was passed.
  61 */
  62int check_connected(oid_iterate_fn fn, void *cb_data,
  63                    struct check_connected_options *opt);
  64
  65#endif /* CONNECTED_H */