FilesExpand file tree

development

/

pack.h

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

117 lines (105 loc) · 2.93 KB

development

/

pack.h

Copy path

Top

File metadata and controls

• Code
• Blame

117 lines (105 loc) · 2.93 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

/*

* Copyright (C) 2009-2012 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_git_pack_h__

#define INCLUDE_git_pack_h__

#include "common.h"

#include "oid.h"

/**

* @file git2/pack.h

* @brief Git pack management routines

* @defgroup git_pack Git pack management routines

* @ingroup Git

* @{

*/

GIT_BEGIN_DECL

/**

* Initialize a new packbuilder

*

* @param out The new packbuilder object

* @param repo The repository

*

* @return 0 or an error code

*/

GIT_EXTERN(int) git_packbuilder_new(git_packbuilder **out, git_repository *repo);

/**

* Set number of threads to spawn

*

* By default, libgit2 won't spawn any threads at all;

* when set to 0, libgit2 will autodetect the number of

* CPUs.

*

* @param pb The packbuilder

* @param n Number of threads to spawn

* @return number of actual threads to be used

*/

GIT_EXTERN(unsigned int) git_packbuilder_set_threads(git_packbuilder *pb, unsigned int n);

/**

* Insert a single object

*

* For an optimal pack it's mandatory to insert objects in recency order,

* commits followed by trees and blobs.

*

* @param pb The packbuilder

* @param id The oid of the commit

* @param name The name; might be NULL

*

* @return 0 or an error code

*/

GIT_EXTERN(int) git_packbuilder_insert(git_packbuilder *pb, const git_oid *id, const char *name);

/**

* Insert a root tree object

*

* This will add the tree as well as all referenced trees and blobs.

*

* @param pb The packbuilder

* @param id The oid of the root tree

*

* @return 0 or an error code

*/

GIT_EXTERN(int) git_packbuilder_insert_tree(git_packbuilder *pb, const git_oid *id);

/**

* Write the new pack and the corresponding index to path

*

* @param pb The packbuilder

* @param path Directory to store the new pack and index

*

* @return 0 or an error code

*/

GIT_EXTERN(int) git_packbuilder_write(git_packbuilder *pb, const char *file);

/**

* Create the new pack and pass each object to the callback

*

* @param pb the packbuilder

* @param cb the callback to call with each packed object's buffer

* @param payload the callback's data

* @return 0 or an error code

*/

typedef int (*git_packbuilder_foreach_cb)(void *buf, size_t size, void *payload);

GIT_EXTERN(int) git_packbuilder_foreach(git_packbuilder *pb, git_packbuilder_foreach_cb cb, void *payload);

/**

* Get the total number of objects the packbuilder will write out

*

* @param pb the packbuilder

* @return

*/

GIT_EXTERN(uint32_t) git_packbuilder_object_count(git_packbuilder *pb);

/**

* Get the number of objects the packbuilder has already written out

*

* @param pb the packbuilder

* @return

*/

GIT_EXTERN(uint32_t) git_packbuilder_written(git_packbuilder *pb);

/**

* Free the packbuilder and all associated data

*

* @param pb The packbuilder

*/

GIT_EXTERN(void) git_packbuilder_free(git_packbuilder *pb);

/** @} */

GIT_END_DECL

#endif