thodg/libgit2/src/pack.h

• Show log

  Commit

• Hash : 01ad7b3a
  Author :
  Date : 2011-09-06T15:48:45
  

  *: correct and codify various file permissions
  
  The following files now have 0444 permissions:
  
  - loose objects
  - pack indexes
  - pack files
  - packs downloaded by fetch
  - packs downloaded by the HTTP transport
  
  And the following files now have 0666 permissions:
  
  - config files
  - repository indexes
  - reflogs
  - refs
  
  This brings libgit2 more in line with Git.
  
  Note that git_filebuf_commit() and git_filebuf_commit_at() have both
  gained a new mode parameter.
  
  The latter change fixes an important issue where filebufs created with
  GIT_FILEBUF_TEMPORARY received 0600 permissions (due to mkstemp(3)
  usage). Now we chmod() the file before renaming it into place.
  
  Tests have been added to confirm that new commit, tag, and tree
  objects are created with the right permissions. I don't have access to
  Windows, so for now I've guarded the tests with "#ifndef GIT_WIN32".
  

Download

• src/pack.h

• /*
   * Copyright (C) 2009-2011 the libgit2 contributors
   *
   * 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_pack_h__
  #define INCLUDE_pack_h__
  
  #include "git2/oid.h"
  
  #include "common.h"
  #include "map.h"
  #include "mwindow.h"
  #include "odb.h"
  
  #define GIT_PACK_FILE_MODE 0444
  
  #define PACK_SIGNATURE 0x5041434b	/* "PACK" */
  #define PACK_VERSION 2
  #define pack_version_ok(v) ((v) == htonl(2) || (v) == htonl(3))
  struct git_pack_header {
  	uint32_t hdr_signature;
  	uint32_t hdr_version;
  	uint32_t hdr_entries;
  };
  
  /*
   * The first four bytes of index formats later than version 1 should
   * start with this signature, as all older git binaries would find this
   * value illegal and abort reading the file.
   *
   * This is the case because the number of objects in a packfile
   * cannot exceed 1,431,660,000 as every object would need at least
   * 3 bytes of data and the overall packfile cannot exceed 4 GiB with
   * version 1 of the index file due to the offsets limited to 32 bits.
   * Clearly the signature exceeds this maximum.
   *
   * Very old git binaries will also compare the first 4 bytes to the
   * next 4 bytes in the index and abort with a "non-monotonic index"
   * error if the second 4 byte word is smaller than the first 4
   * byte word. This would be true in the proposed future index
   * format as idx_signature would be greater than idx_version.
   */
  
  #define PACK_IDX_SIGNATURE 0xff744f63	/* "\377tOc" */
  
  struct git_pack_idx_header {
  	uint32_t idx_signature;
  	uint32_t idx_version;
  };
  
  struct git_pack_file {
  	git_mwindow_file mwf;
  	git_map index_map;
  
  	uint32_t num_objects;
  	uint32_t num_bad_objects;
  	git_oid *bad_object_sha1; /* array of git_oid */
  
  	int index_version;
  	git_time_t mtime;
  	unsigned pack_local:1, pack_keep:1, has_cache:1;
  	git_oid sha1;
  	git_vector cache;
  
  	/* something like ".git/objects/pack/xxxxx.pack" */
  	char pack_name[GIT_FLEX_ARRAY]; /* more */
  };
  
  struct git_pack_entry {
  	off_t offset;
  	git_oid sha1;
  	struct git_pack_file *p;
  };
  
  int git_packfile_unpack_header(
  		size_t *size_p,
  		git_otype *type_p,
  		git_mwindow_file *mwf,
  		git_mwindow **w_curs,
  		off_t *curpos);
  
  int git_packfile_unpack(git_rawobj *obj, struct git_pack_file *p, off_t *obj_offset);
  
  off_t get_delta_base(struct git_pack_file *p, git_mwindow **w_curs,
  		off_t *curpos, git_otype type,
  		off_t delta_obj_offset);
  
  void packfile_free(struct git_pack_file *p);
  int git_packfile_check(struct git_pack_file **pack_out, const char *path);
  int git_pack_entry_find(
  		struct git_pack_entry *e,
  		struct git_pack_file *p,
  		const git_oid *short_oid,
  		unsigned int len);
  
  #endif
  

Download