Documentation/gitprotocol-v2.txt: fix a slight inconsistency in format
[git/gitster.git] / streaming.c
blob27841dc1d9e535df291a1005a7a005d65323dd1d
1 /*
2 * Copyright (c) 2011, Google Inc.
3 */
4 #include "cache.h"
5 #include "streaming.h"
6 #include "repository.h"
7 #include "object-store.h"
8 #include "replace-object.h"
9 #include "packfile.h"
11 typedef int (*open_istream_fn)(struct git_istream *,
12 struct repository *,
13 const struct object_id *,
14 enum object_type *);
15 typedef int (*close_istream_fn)(struct git_istream *);
16 typedef ssize_t (*read_istream_fn)(struct git_istream *, char *, size_t);
18 #define FILTER_BUFFER (1024*16)
20 struct filtered_istream {
21 struct git_istream *upstream;
22 struct stream_filter *filter;
23 char ibuf[FILTER_BUFFER];
24 char obuf[FILTER_BUFFER];
25 int i_end, i_ptr;
26 int o_end, o_ptr;
27 int input_finished;
30 struct git_istream {
31 open_istream_fn open;
32 close_istream_fn close;
33 read_istream_fn read;
35 unsigned long size; /* inflated size of full object */
36 git_zstream z;
37 enum { z_unused, z_used, z_done, z_error } z_state;
39 union {
40 struct {
41 char *buf; /* from oid_object_info_extended() */
42 unsigned long read_ptr;
43 } incore;
45 struct {
46 void *mapped;
47 unsigned long mapsize;
48 char hdr[32];
49 int hdr_avail;
50 int hdr_used;
51 } loose;
53 struct {
54 struct packed_git *pack;
55 off_t pos;
56 } in_pack;
58 struct filtered_istream filtered;
59 } u;
62 /*****************************************************************
64 * Common helpers
66 *****************************************************************/
68 static void close_deflated_stream(struct git_istream *st)
70 if (st->z_state == z_used)
71 git_inflate_end(&st->z);
75 /*****************************************************************
77 * Filtered stream
79 *****************************************************************/
81 static int close_istream_filtered(struct git_istream *st)
83 free_stream_filter(st->u.filtered.filter);
84 return close_istream(st->u.filtered.upstream);
87 static ssize_t read_istream_filtered(struct git_istream *st, char *buf,
88 size_t sz)
90 struct filtered_istream *fs = &(st->u.filtered);
91 size_t filled = 0;
93 while (sz) {
94 /* do we already have filtered output? */
95 if (fs->o_ptr < fs->o_end) {
96 size_t to_move = fs->o_end - fs->o_ptr;
97 if (sz < to_move)
98 to_move = sz;
99 memcpy(buf + filled, fs->obuf + fs->o_ptr, to_move);
100 fs->o_ptr += to_move;
101 sz -= to_move;
102 filled += to_move;
103 continue;
105 fs->o_end = fs->o_ptr = 0;
107 /* do we have anything to feed the filter with? */
108 if (fs->i_ptr < fs->i_end) {
109 size_t to_feed = fs->i_end - fs->i_ptr;
110 size_t to_receive = FILTER_BUFFER;
111 if (stream_filter(fs->filter,
112 fs->ibuf + fs->i_ptr, &to_feed,
113 fs->obuf, &to_receive))
114 return -1;
115 fs->i_ptr = fs->i_end - to_feed;
116 fs->o_end = FILTER_BUFFER - to_receive;
117 continue;
120 /* tell the filter to drain upon no more input */
121 if (fs->input_finished) {
122 size_t to_receive = FILTER_BUFFER;
123 if (stream_filter(fs->filter,
124 NULL, NULL,
125 fs->obuf, &to_receive))
126 return -1;
127 fs->o_end = FILTER_BUFFER - to_receive;
128 if (!fs->o_end)
129 break;
130 continue;
132 fs->i_end = fs->i_ptr = 0;
134 /* refill the input from the upstream */
135 if (!fs->input_finished) {
136 fs->i_end = read_istream(fs->upstream, fs->ibuf, FILTER_BUFFER);
137 if (fs->i_end < 0)
138 return -1;
139 if (fs->i_end)
140 continue;
142 fs->input_finished = 1;
144 return filled;
147 static struct git_istream *attach_stream_filter(struct git_istream *st,
148 struct stream_filter *filter)
150 struct git_istream *ifs = xmalloc(sizeof(*ifs));
151 struct filtered_istream *fs = &(ifs->u.filtered);
153 ifs->close = close_istream_filtered;
154 ifs->read = read_istream_filtered;
155 fs->upstream = st;
156 fs->filter = filter;
157 fs->i_end = fs->i_ptr = 0;
158 fs->o_end = fs->o_ptr = 0;
159 fs->input_finished = 0;
160 ifs->size = -1; /* unknown */
161 return ifs;
164 /*****************************************************************
166 * Loose object stream
168 *****************************************************************/
170 static ssize_t read_istream_loose(struct git_istream *st, char *buf, size_t sz)
172 size_t total_read = 0;
174 switch (st->z_state) {
175 case z_done:
176 return 0;
177 case z_error:
178 return -1;
179 default:
180 break;
183 if (st->u.loose.hdr_used < st->u.loose.hdr_avail) {
184 size_t to_copy = st->u.loose.hdr_avail - st->u.loose.hdr_used;
185 if (sz < to_copy)
186 to_copy = sz;
187 memcpy(buf, st->u.loose.hdr + st->u.loose.hdr_used, to_copy);
188 st->u.loose.hdr_used += to_copy;
189 total_read += to_copy;
192 while (total_read < sz) {
193 int status;
195 st->z.next_out = (unsigned char *)buf + total_read;
196 st->z.avail_out = sz - total_read;
197 status = git_inflate(&st->z, Z_FINISH);
199 total_read = st->z.next_out - (unsigned char *)buf;
201 if (status == Z_STREAM_END) {
202 git_inflate_end(&st->z);
203 st->z_state = z_done;
204 break;
206 if (status != Z_OK && (status != Z_BUF_ERROR || total_read < sz)) {
207 git_inflate_end(&st->z);
208 st->z_state = z_error;
209 return -1;
212 return total_read;
215 static int close_istream_loose(struct git_istream *st)
217 close_deflated_stream(st);
218 munmap(st->u.loose.mapped, st->u.loose.mapsize);
219 return 0;
222 static int open_istream_loose(struct git_istream *st, struct repository *r,
223 const struct object_id *oid,
224 enum object_type *type)
226 struct object_info oi = OBJECT_INFO_INIT;
227 oi.sizep = &st->size;
228 oi.typep = type;
230 st->u.loose.mapped = map_loose_object(r, oid, &st->u.loose.mapsize);
231 if (!st->u.loose.mapped)
232 return -1;
233 switch (unpack_loose_header(&st->z, st->u.loose.mapped,
234 st->u.loose.mapsize, st->u.loose.hdr,
235 sizeof(st->u.loose.hdr), NULL)) {
236 case ULHR_OK:
237 break;
238 case ULHR_BAD:
239 case ULHR_TOO_LONG:
240 goto error;
242 if (parse_loose_header(st->u.loose.hdr, &oi) < 0 || *type < 0)
243 goto error;
245 st->u.loose.hdr_used = strlen(st->u.loose.hdr) + 1;
246 st->u.loose.hdr_avail = st->z.total_out;
247 st->z_state = z_used;
248 st->close = close_istream_loose;
249 st->read = read_istream_loose;
251 return 0;
252 error:
253 git_inflate_end(&st->z);
254 munmap(st->u.loose.mapped, st->u.loose.mapsize);
255 return -1;
259 /*****************************************************************
261 * Non-delta packed object stream
263 *****************************************************************/
265 static ssize_t read_istream_pack_non_delta(struct git_istream *st, char *buf,
266 size_t sz)
268 size_t total_read = 0;
270 switch (st->z_state) {
271 case z_unused:
272 memset(&st->z, 0, sizeof(st->z));
273 git_inflate_init(&st->z);
274 st->z_state = z_used;
275 break;
276 case z_done:
277 return 0;
278 case z_error:
279 return -1;
280 case z_used:
281 break;
284 while (total_read < sz) {
285 int status;
286 struct pack_window *window = NULL;
287 unsigned char *mapped;
289 mapped = use_pack(st->u.in_pack.pack, &window,
290 st->u.in_pack.pos, &st->z.avail_in);
292 st->z.next_out = (unsigned char *)buf + total_read;
293 st->z.avail_out = sz - total_read;
294 st->z.next_in = mapped;
295 status = git_inflate(&st->z, Z_FINISH);
297 st->u.in_pack.pos += st->z.next_in - mapped;
298 total_read = st->z.next_out - (unsigned char *)buf;
299 unuse_pack(&window);
301 if (status == Z_STREAM_END) {
302 git_inflate_end(&st->z);
303 st->z_state = z_done;
304 break;
308 * Unlike the loose object case, we do not have to worry here
309 * about running out of input bytes and spinning infinitely. If
310 * we get Z_BUF_ERROR due to too few input bytes, then we'll
311 * replenish them in the next use_pack() call when we loop. If
312 * we truly hit the end of the pack (i.e., because it's corrupt
313 * or truncated), then use_pack() catches that and will die().
315 if (status != Z_OK && status != Z_BUF_ERROR) {
316 git_inflate_end(&st->z);
317 st->z_state = z_error;
318 return -1;
321 return total_read;
324 static int close_istream_pack_non_delta(struct git_istream *st)
326 close_deflated_stream(st);
327 return 0;
330 static int open_istream_pack_non_delta(struct git_istream *st,
331 struct repository *r UNUSED,
332 const struct object_id *oid UNUSED,
333 enum object_type *type UNUSED)
335 struct pack_window *window;
336 enum object_type in_pack_type;
338 window = NULL;
340 in_pack_type = unpack_object_header(st->u.in_pack.pack,
341 &window,
342 &st->u.in_pack.pos,
343 &st->size);
344 unuse_pack(&window);
345 switch (in_pack_type) {
346 default:
347 return -1; /* we do not do deltas for now */
348 case OBJ_COMMIT:
349 case OBJ_TREE:
350 case OBJ_BLOB:
351 case OBJ_TAG:
352 break;
354 st->z_state = z_unused;
355 st->close = close_istream_pack_non_delta;
356 st->read = read_istream_pack_non_delta;
358 return 0;
362 /*****************************************************************
364 * In-core stream
366 *****************************************************************/
368 static int close_istream_incore(struct git_istream *st)
370 free(st->u.incore.buf);
371 return 0;
374 static ssize_t read_istream_incore(struct git_istream *st, char *buf, size_t sz)
376 size_t read_size = sz;
377 size_t remainder = st->size - st->u.incore.read_ptr;
379 if (remainder <= read_size)
380 read_size = remainder;
381 if (read_size) {
382 memcpy(buf, st->u.incore.buf + st->u.incore.read_ptr, read_size);
383 st->u.incore.read_ptr += read_size;
385 return read_size;
388 static int open_istream_incore(struct git_istream *st, struct repository *r,
389 const struct object_id *oid, enum object_type *type)
391 struct object_info oi = OBJECT_INFO_INIT;
393 st->u.incore.read_ptr = 0;
394 st->close = close_istream_incore;
395 st->read = read_istream_incore;
397 oi.typep = type;
398 oi.sizep = &st->size;
399 oi.contentp = (void **)&st->u.incore.buf;
400 return oid_object_info_extended(r, oid, &oi,
401 OBJECT_INFO_DIE_IF_CORRUPT);
404 /*****************************************************************************
405 * static helpers variables and functions for users of streaming interface
406 *****************************************************************************/
408 static int istream_source(struct git_istream *st,
409 struct repository *r,
410 const struct object_id *oid,
411 enum object_type *type)
413 unsigned long size;
414 int status;
415 struct object_info oi = OBJECT_INFO_INIT;
417 oi.typep = type;
418 oi.sizep = &size;
419 status = oid_object_info_extended(r, oid, &oi, 0);
420 if (status < 0)
421 return status;
423 switch (oi.whence) {
424 case OI_LOOSE:
425 st->open = open_istream_loose;
426 return 0;
427 case OI_PACKED:
428 if (!oi.u.packed.is_delta && big_file_threshold < size) {
429 st->u.in_pack.pack = oi.u.packed.pack;
430 st->u.in_pack.pos = oi.u.packed.offset;
431 st->open = open_istream_pack_non_delta;
432 return 0;
434 /* fallthru */
435 default:
436 st->open = open_istream_incore;
437 return 0;
441 /****************************************************************
442 * Users of streaming interface
443 ****************************************************************/
445 int close_istream(struct git_istream *st)
447 int r = st->close(st);
448 free(st);
449 return r;
452 ssize_t read_istream(struct git_istream *st, void *buf, size_t sz)
454 return st->read(st, buf, sz);
457 struct git_istream *open_istream(struct repository *r,
458 const struct object_id *oid,
459 enum object_type *type,
460 unsigned long *size,
461 struct stream_filter *filter)
463 struct git_istream *st = xmalloc(sizeof(*st));
464 const struct object_id *real = lookup_replace_object(r, oid);
465 int ret = istream_source(st, r, real, type);
467 if (ret) {
468 free(st);
469 return NULL;
472 if (st->open(st, r, real, type)) {
473 if (open_istream_incore(st, r, real, type)) {
474 free(st);
475 return NULL;
478 if (filter) {
479 /* Add "&& !is_null_stream_filter(filter)" for performance */
480 struct git_istream *nst = attach_stream_filter(st, filter);
481 if (!nst) {
482 close_istream(st);
483 return NULL;
485 st = nst;
488 *size = st->size;
489 return st;
492 int stream_blob_to_fd(int fd, const struct object_id *oid, struct stream_filter *filter,
493 int can_seek)
495 struct git_istream *st;
496 enum object_type type;
497 unsigned long sz;
498 ssize_t kept = 0;
499 int result = -1;
501 st = open_istream(the_repository, oid, &type, &sz, filter);
502 if (!st) {
503 if (filter)
504 free_stream_filter(filter);
505 return result;
507 if (type != OBJ_BLOB)
508 goto close_and_exit;
509 for (;;) {
510 char buf[1024 * 16];
511 ssize_t wrote, holeto;
512 ssize_t readlen = read_istream(st, buf, sizeof(buf));
514 if (readlen < 0)
515 goto close_and_exit;
516 if (!readlen)
517 break;
518 if (can_seek && sizeof(buf) == readlen) {
519 for (holeto = 0; holeto < readlen; holeto++)
520 if (buf[holeto])
521 break;
522 if (readlen == holeto) {
523 kept += holeto;
524 continue;
528 if (kept && lseek(fd, kept, SEEK_CUR) == (off_t) -1)
529 goto close_and_exit;
530 else
531 kept = 0;
532 wrote = write_in_full(fd, buf, readlen);
534 if (wrote < 0)
535 goto close_and_exit;
537 if (kept && (lseek(fd, kept - 1, SEEK_CUR) == (off_t) -1 ||
538 xwrite(fd, "", 1) != 1))
539 goto close_and_exit;
540 result = 0;
542 close_and_exit:
543 close_istream(st);
544 return result;