thodg/libgit2/src/blob.h

• Show log

  Commit

• Hash : 9ac79ecc
  Author :
  Date : 2017-10-13T13:15:13
  

  blob: implement function to parse raw data Currently, parsing objects is strictly tied to having an ODB object available. This makes it hard to parse an object when all that is available is its raw object and size. Furthermore, hacking around that limitation by directly creating an ODB structure either on stack or on heap does not really work that well due to ODB objects being reference counted and then automatically free'd when reaching a reference count of zero. In some occasions parsing raw objects without touching the ODB is actually recuired, though. One use case is for example object verification, where we want to assure that an object is valid before inserting it into the ODB or writing it into the git repository. Asa first step towards that, introduce a distinction between raw and ODB objects for blobs. Creation of ODB objects stays the same by simply using `git_blob__parse`, but a new function `git_blob__parse_raw` has been added that creates a blob from a pair of data and size. By setting a new flag inside of the blob, we can now distinguish whether it is a raw or ODB object now and treat it accordingly in several places. Note that the blob data passed in is not being copied. Because of that, callers need to make sure to keep it alive during the blob's life time. This is being used to avoid unnecessarily increasing the memory footprint when parsing largish blobs.

Download

• src/blob.h

• /*
   * Copyright (C) the libgit2 contributors. All rights reserved.
   *
   * This file is part of libgit2, distributed under the GNU GPL v2 with
   * a Linking Exception. For full terms see the included COPYING file.
   */
  #ifndef INCLUDE_blob_h__
  #define INCLUDE_blob_h__
  
  #include "common.h"
  
  #include "git2/blob.h"
  #include "repository.h"
  #include "odb.h"
  #include "fileops.h"
  
  struct git_blob {
  	git_object object;
  
  	union {
  		git_odb_object *odb;
  		struct {
  			const char *data;
  			git_off_t size;
  		} raw;
  	} data;
  	unsigned int raw:1;
  };
  
  void git_blob__free(void *blob);
  int git_blob__parse(void *blob, git_odb_object *obj);
  int git_blob__parse_raw(void *blob, const char *data, size_t size);
  int git_blob__getbuf(git_buf *buffer, git_blob *blob);
  
  extern int git_blob__create_from_paths(
  	git_oid *out_oid,
  	struct stat *out_st,
  	git_repository *repo,
  	const char *full_path,
  	const char *hint_path,
  	mode_t hint_mode,
  	bool apply_filters);
  
  #endif
  

Download