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