]>
git.proxmox.com Git - libgit2.git/blob - src/filebuf.h
2 * Copyright (C) 2009-2012 the libgit2 contributors
4 * This file is part of libgit2, distributed under the GNU GPL v2 with
5 * a Linking Exception. For full terms see the included COPYING file.
7 #ifndef INCLUDE_filebuf_h__
8 #define INCLUDE_filebuf_h__
15 # define GIT_FILEBUF_THREADS
18 #define GIT_FILEBUF_HASH_CONTENTS (1 << 0)
19 #define GIT_FILEBUF_APPEND (1 << 2)
20 #define GIT_FILEBUF_FORCE (1 << 3)
21 #define GIT_FILEBUF_TEMPORARY (1 << 4)
22 #define GIT_FILEBUF_DO_NOT_BUFFER (1 << 5)
23 #define GIT_FILEBUF_DEFLATE_SHIFT (6)
25 #define GIT_FILELOCK_EXTENSION ".lock\0"
26 #define GIT_FILELOCK_EXTLENGTH 6
32 int (*write
)(struct git_filebuf
*file
, void *source
, size_t len
);
37 unsigned char *buffer
;
43 size_t buf_size
, buf_pos
;
50 typedef struct git_filebuf git_filebuf
;
52 #define GIT_FILEBUF_INIT {0}
55 * The git_filebuf object lifecycle is:
56 * - Allocate git_filebuf, preferably using GIT_FILEBUF_INIT.
58 * - Call git_filebuf_open() to initialize the filebuf for use.
60 * - Make as many calls to git_filebuf_write(), git_filebuf_printf(),
61 * git_filebuf_reserve() as you like. The error codes for these
62 * functions don't need to be checked. They are stored internally
65 * - While you are writing, you may call git_filebuf_hash() to get
66 * the hash of all you have written so far. This function will
67 * fail if any of the previous writes to the buffer failed.
69 * - To close the git_filebuf, you may call git_filebuf_commit() or
70 * git_filebuf_commit_at() to save the file, or
71 * git_filebuf_cleanup() to abandon the file. All of these will
72 * free the git_filebuf object. Likewise, all of these will fail
73 * if any of the previous writes to the buffer failed, and set
74 * an error code accordingly.
76 int git_filebuf_write(git_filebuf
*lock
, const void *buff
, size_t len
);
77 int git_filebuf_reserve(git_filebuf
*file
, void **buff
, size_t len
);
78 int git_filebuf_printf(git_filebuf
*file
, const char *format
, ...) GIT_FORMAT_PRINTF(2, 3);
80 int git_filebuf_open(git_filebuf
*lock
, const char *path
, int flags
);
81 int git_filebuf_commit(git_filebuf
*lock
, mode_t mode
);
82 int git_filebuf_commit_at(git_filebuf
*lock
, const char *path
, mode_t mode
);
83 void git_filebuf_cleanup(git_filebuf
*lock
);
84 int git_filebuf_hash(git_oid
*oid
, git_filebuf
*file
);
85 int git_filebuf_flush(git_filebuf
*file
);
86 int git_filebuf_stats(time_t *mtime
, size_t *size
, git_filebuf
*file
);