Merge branch 'jt/clone-recursesub-ref-advise'
[git] / pkt-line.c
1 #include "cache.h"
2 #include "pkt-line.h"
3 #include "run-command.h"
4
5 char packet_buffer[LARGE_PACKET_MAX];
6 static const char *packet_trace_prefix = "git";
7 static struct trace_key trace_packet = TRACE_KEY_INIT(PACKET);
8 static struct trace_key trace_pack = TRACE_KEY_INIT(PACKFILE);
9
10 void packet_trace_identity(const char *prog)
11 {
12         packet_trace_prefix = xstrdup(prog);
13 }
14
15 static const char *get_trace_prefix(void)
16 {
17         return in_async() ? "sideband" : packet_trace_prefix;
18 }
19
20 static int packet_trace_pack(const char *buf, unsigned int len, int sideband)
21 {
22         if (!sideband) {
23                 trace_verbatim(&trace_pack, buf, len);
24                 return 1;
25         } else if (len && *buf == '\1') {
26                 trace_verbatim(&trace_pack, buf + 1, len - 1);
27                 return 1;
28         } else {
29                 /* it's another non-pack sideband */
30                 return 0;
31         }
32 }
33
34 static void packet_trace(const char *buf, unsigned int len, int write)
35 {
36         int i;
37         struct strbuf out;
38         static int in_pack, sideband;
39
40         if (!trace_want(&trace_packet) && !trace_want(&trace_pack))
41                 return;
42
43         if (in_pack) {
44                 if (packet_trace_pack(buf, len, sideband))
45                         return;
46         } else if (starts_with(buf, "PACK") || starts_with(buf, "\1PACK")) {
47                 in_pack = 1;
48                 sideband = *buf == '\1';
49                 packet_trace_pack(buf, len, sideband);
50
51                 /*
52                  * Make a note in the human-readable trace that the pack data
53                  * started.
54                  */
55                 buf = "PACK ...";
56                 len = strlen(buf);
57         }
58
59         if (!trace_want(&trace_packet))
60                 return;
61
62         /* +32 is just a guess for header + quoting */
63         strbuf_init(&out, len+32);
64
65         strbuf_addf(&out, "packet: %12s%c ",
66                     get_trace_prefix(), write ? '>' : '<');
67
68         /* XXX we should really handle printable utf8 */
69         for (i = 0; i < len; i++) {
70                 /* suppress newlines */
71                 if (buf[i] == '\n')
72                         continue;
73                 if (buf[i] >= 0x20 && buf[i] <= 0x7e)
74                         strbuf_addch(&out, buf[i]);
75                 else
76                         strbuf_addf(&out, "\\%o", buf[i]);
77         }
78
79         strbuf_addch(&out, '\n');
80         trace_strbuf(&trace_packet, &out);
81         strbuf_release(&out);
82 }
83
84 /*
85  * If we buffered things up above (we don't, but we should),
86  * we'd flush it here
87  */
88 void packet_flush(int fd)
89 {
90         packet_trace("0000", 4, 1);
91         if (write_in_full(fd, "0000", 4) < 0)
92                 die_errno(_("unable to write flush packet"));
93 }
94
95 void packet_delim(int fd)
96 {
97         packet_trace("0001", 4, 1);
98         if (write_in_full(fd, "0001", 4) < 0)
99                 die_errno(_("unable to write delim packet"));
100 }
101
102 int packet_flush_gently(int fd)
103 {
104         packet_trace("0000", 4, 1);
105         if (write_in_full(fd, "0000", 4) < 0)
106                 return error(_("flush packet write failed"));
107         return 0;
108 }
109
110 void packet_buf_flush(struct strbuf *buf)
111 {
112         packet_trace("0000", 4, 1);
113         strbuf_add(buf, "0000", 4);
114 }
115
116 void packet_buf_delim(struct strbuf *buf)
117 {
118         packet_trace("0001", 4, 1);
119         strbuf_add(buf, "0001", 4);
120 }
121
122 void set_packet_header(char *buf, int size)
123 {
124         static char hexchar[] = "0123456789abcdef";
125
126         #define hex(a) (hexchar[(a) & 15])
127         buf[0] = hex(size >> 12);
128         buf[1] = hex(size >> 8);
129         buf[2] = hex(size >> 4);
130         buf[3] = hex(size);
131         #undef hex
132 }
133
134 static void format_packet(struct strbuf *out, const char *prefix,
135                           const char *fmt, va_list args)
136 {
137         size_t orig_len, n;
138
139         orig_len = out->len;
140         strbuf_addstr(out, "0000");
141         strbuf_addstr(out, prefix);
142         strbuf_vaddf(out, fmt, args);
143         n = out->len - orig_len;
144
145         if (n > LARGE_PACKET_MAX)
146                 die(_("protocol error: impossibly long line"));
147
148         set_packet_header(&out->buf[orig_len], n);
149         packet_trace(out->buf + orig_len + 4, n - 4, 1);
150 }
151
152 static int packet_write_fmt_1(int fd, int gently, const char *prefix,
153                               const char *fmt, va_list args)
154 {
155         static struct strbuf buf = STRBUF_INIT;
156
157         strbuf_reset(&buf);
158         format_packet(&buf, prefix, fmt, args);
159         if (write_in_full(fd, buf.buf, buf.len) < 0) {
160                 if (!gently) {
161                         check_pipe(errno);
162                         die_errno(_("packet write with format failed"));
163                 }
164                 return error(_("packet write with format failed"));
165         }
166
167         return 0;
168 }
169
170 void packet_write_fmt(int fd, const char *fmt, ...)
171 {
172         va_list args;
173
174         va_start(args, fmt);
175         packet_write_fmt_1(fd, 0, "", fmt, args);
176         va_end(args);
177 }
178
179 int packet_write_fmt_gently(int fd, const char *fmt, ...)
180 {
181         int status;
182         va_list args;
183
184         va_start(args, fmt);
185         status = packet_write_fmt_1(fd, 1, "", fmt, args);
186         va_end(args);
187         return status;
188 }
189
190 static int packet_write_gently(const int fd_out, const char *buf, size_t size)
191 {
192         static char packet_write_buffer[LARGE_PACKET_MAX];
193         size_t packet_size;
194
195         if (size > sizeof(packet_write_buffer) - 4)
196                 return error(_("packet write failed - data exceeds max packet size"));
197
198         packet_trace(buf, size, 1);
199         packet_size = size + 4;
200         set_packet_header(packet_write_buffer, packet_size);
201         memcpy(packet_write_buffer + 4, buf, size);
202         if (write_in_full(fd_out, packet_write_buffer, packet_size) < 0)
203                 return error(_("packet write failed"));
204         return 0;
205 }
206
207 void packet_write(int fd_out, const char *buf, size_t size)
208 {
209         if (packet_write_gently(fd_out, buf, size))
210                 die_errno(_("packet write failed"));
211 }
212
213 void packet_buf_write(struct strbuf *buf, const char *fmt, ...)
214 {
215         va_list args;
216
217         va_start(args, fmt);
218         format_packet(buf, "", fmt, args);
219         va_end(args);
220 }
221
222 void packet_buf_write_len(struct strbuf *buf, const char *data, size_t len)
223 {
224         size_t orig_len, n;
225
226         orig_len = buf->len;
227         strbuf_addstr(buf, "0000");
228         strbuf_add(buf, data, len);
229         n = buf->len - orig_len;
230
231         if (n > LARGE_PACKET_MAX)
232                 die(_("protocol error: impossibly long line"));
233
234         set_packet_header(&buf->buf[orig_len], n);
235         packet_trace(data, len, 1);
236 }
237
238 int write_packetized_from_fd(int fd_in, int fd_out)
239 {
240         static char buf[LARGE_PACKET_DATA_MAX];
241         int err = 0;
242         ssize_t bytes_to_write;
243
244         while (!err) {
245                 bytes_to_write = xread(fd_in, buf, sizeof(buf));
246                 if (bytes_to_write < 0)
247                         return COPY_READ_ERROR;
248                 if (bytes_to_write == 0)
249                         break;
250                 err = packet_write_gently(fd_out, buf, bytes_to_write);
251         }
252         if (!err)
253                 err = packet_flush_gently(fd_out);
254         return err;
255 }
256
257 int write_packetized_from_buf(const char *src_in, size_t len, int fd_out)
258 {
259         int err = 0;
260         size_t bytes_written = 0;
261         size_t bytes_to_write;
262
263         while (!err) {
264                 if ((len - bytes_written) > LARGE_PACKET_DATA_MAX)
265                         bytes_to_write = LARGE_PACKET_DATA_MAX;
266                 else
267                         bytes_to_write = len - bytes_written;
268                 if (bytes_to_write == 0)
269                         break;
270                 err = packet_write_gently(fd_out, src_in + bytes_written, bytes_to_write);
271                 bytes_written += bytes_to_write;
272         }
273         if (!err)
274                 err = packet_flush_gently(fd_out);
275         return err;
276 }
277
278 static int get_packet_data(int fd, char **src_buf, size_t *src_size,
279                            void *dst, unsigned size, int options)
280 {
281         ssize_t ret;
282
283         if (fd >= 0 && src_buf && *src_buf)
284                 BUG("multiple sources given to packet_read");
285
286         /* Read up to "size" bytes from our source, whatever it is. */
287         if (src_buf && *src_buf) {
288                 ret = size < *src_size ? size : *src_size;
289                 memcpy(dst, *src_buf, ret);
290                 *src_buf += ret;
291                 *src_size -= ret;
292         } else {
293                 ret = read_in_full(fd, dst, size);
294                 if (ret < 0)
295                         die_errno(_("read error"));
296         }
297
298         /* And complain if we didn't get enough bytes to satisfy the read. */
299         if (ret != size) {
300                 if (options & PACKET_READ_GENTLE_ON_EOF)
301                         return -1;
302
303                 die(_("the remote end hung up unexpectedly"));
304         }
305
306         return ret;
307 }
308
309 static int packet_length(const char *linelen)
310 {
311         int val = hex2chr(linelen);
312         return (val < 0) ? val : (val << 8) | hex2chr(linelen + 2);
313 }
314
315 enum packet_read_status packet_read_with_status(int fd, char **src_buffer,
316                                                 size_t *src_len, char *buffer,
317                                                 unsigned size, int *pktlen,
318                                                 int options)
319 {
320         int len;
321         char linelen[4];
322
323         if (get_packet_data(fd, src_buffer, src_len, linelen, 4, options) < 0) {
324                 *pktlen = -1;
325                 return PACKET_READ_EOF;
326         }
327
328         len = packet_length(linelen);
329
330         if (len < 0) {
331                 die(_("protocol error: bad line length character: %.4s"), linelen);
332         } else if (!len) {
333                 packet_trace("0000", 4, 0);
334                 *pktlen = 0;
335                 return PACKET_READ_FLUSH;
336         } else if (len == 1) {
337                 packet_trace("0001", 4, 0);
338                 *pktlen = 0;
339                 return PACKET_READ_DELIM;
340         } else if (len < 4) {
341                 die(_("protocol error: bad line length %d"), len);
342         }
343
344         len -= 4;
345         if ((unsigned)len >= size)
346                 die(_("protocol error: bad line length %d"), len);
347
348         if (get_packet_data(fd, src_buffer, src_len, buffer, len, options) < 0) {
349                 *pktlen = -1;
350                 return PACKET_READ_EOF;
351         }
352
353         if ((options & PACKET_READ_CHOMP_NEWLINE) &&
354             len && buffer[len-1] == '\n')
355                 len--;
356
357         buffer[len] = 0;
358         packet_trace(buffer, len, 0);
359
360         if ((options & PACKET_READ_DIE_ON_ERR_PACKET) &&
361             starts_with(buffer, "ERR "))
362                 die(_("remote error: %s"), buffer + 4);
363
364         *pktlen = len;
365         return PACKET_READ_NORMAL;
366 }
367
368 int packet_read(int fd, char **src_buffer, size_t *src_len,
369                 char *buffer, unsigned size, int options)
370 {
371         int pktlen = -1;
372
373         packet_read_with_status(fd, src_buffer, src_len, buffer, size,
374                                 &pktlen, options);
375
376         return pktlen;
377 }
378
379 static char *packet_read_line_generic(int fd,
380                                       char **src, size_t *src_len,
381                                       int *dst_len)
382 {
383         int len = packet_read(fd, src, src_len,
384                               packet_buffer, sizeof(packet_buffer),
385                               PACKET_READ_CHOMP_NEWLINE);
386         if (dst_len)
387                 *dst_len = len;
388         return (len > 0) ? packet_buffer : NULL;
389 }
390
391 char *packet_read_line(int fd, int *len_p)
392 {
393         return packet_read_line_generic(fd, NULL, NULL, len_p);
394 }
395
396 int packet_read_line_gently(int fd, int *dst_len, char **dst_line)
397 {
398         int len = packet_read(fd, NULL, NULL,
399                               packet_buffer, sizeof(packet_buffer),
400                               PACKET_READ_CHOMP_NEWLINE|PACKET_READ_GENTLE_ON_EOF);
401         if (dst_len)
402                 *dst_len = len;
403         if (dst_line)
404                 *dst_line = (len > 0) ? packet_buffer : NULL;
405         return len;
406 }
407
408 char *packet_read_line_buf(char **src, size_t *src_len, int *dst_len)
409 {
410         return packet_read_line_generic(-1, src, src_len, dst_len);
411 }
412
413 ssize_t read_packetized_to_strbuf(int fd_in, struct strbuf *sb_out)
414 {
415         int packet_len;
416
417         size_t orig_len = sb_out->len;
418         size_t orig_alloc = sb_out->alloc;
419
420         for (;;) {
421                 strbuf_grow(sb_out, LARGE_PACKET_DATA_MAX);
422                 packet_len = packet_read(fd_in, NULL, NULL,
423                         /* strbuf_grow() above always allocates one extra byte to
424                          * store a '\0' at the end of the string. packet_read()
425                          * writes a '\0' extra byte at the end, too. Let it know
426                          * that there is already room for the extra byte.
427                          */
428                         sb_out->buf + sb_out->len, LARGE_PACKET_DATA_MAX+1,
429                         PACKET_READ_GENTLE_ON_EOF);
430                 if (packet_len <= 0)
431                         break;
432                 sb_out->len += packet_len;
433         }
434
435         if (packet_len < 0) {
436                 if (orig_alloc == 0)
437                         strbuf_release(sb_out);
438                 else
439                         strbuf_setlen(sb_out, orig_len);
440                 return packet_len;
441         }
442         return sb_out->len - orig_len;
443 }
444
445 int recv_sideband(const char *me, int in_stream, int out)
446 {
447         char buf[LARGE_PACKET_MAX + 1];
448         int len;
449         struct strbuf scratch = STRBUF_INIT;
450         enum sideband_type sideband_type;
451
452         while (1) {
453                 len = packet_read(in_stream, NULL, NULL, buf, LARGE_PACKET_MAX,
454                                   0);
455                 if (!demultiplex_sideband(me, buf, len, 0, &scratch,
456                                           &sideband_type))
457                         continue;
458                 switch (sideband_type) {
459                 case SIDEBAND_PRIMARY:
460                         write_or_die(out, buf + 1, len - 1);
461                         break;
462                 default: /* errors: message already written */
463                         return sideband_type;
464                 }
465         }
466 }
467
468 /* Packet Reader Functions */
469 void packet_reader_init(struct packet_reader *reader, int fd,
470                         char *src_buffer, size_t src_len,
471                         int options)
472 {
473         memset(reader, 0, sizeof(*reader));
474
475         reader->fd = fd;
476         reader->src_buffer = src_buffer;
477         reader->src_len = src_len;
478         reader->buffer = packet_buffer;
479         reader->buffer_size = sizeof(packet_buffer);
480         reader->options = options;
481         reader->me = "git";
482 }
483
484 enum packet_read_status packet_reader_read(struct packet_reader *reader)
485 {
486         struct strbuf scratch = STRBUF_INIT;
487
488         if (reader->line_peeked) {
489                 reader->line_peeked = 0;
490                 return reader->status;
491         }
492
493         /*
494          * Consume all progress packets until a primary payload packet is
495          * received
496          */
497         while (1) {
498                 enum sideband_type sideband_type;
499                 reader->status = packet_read_with_status(reader->fd,
500                                                          &reader->src_buffer,
501                                                          &reader->src_len,
502                                                          reader->buffer,
503                                                          reader->buffer_size,
504                                                          &reader->pktlen,
505                                                          reader->options);
506                 if (!reader->use_sideband)
507                         break;
508                 if (demultiplex_sideband(reader->me, reader->buffer,
509                                          reader->pktlen, 1, &scratch,
510                                          &sideband_type))
511                         break;
512         }
513
514         if (reader->status == PACKET_READ_NORMAL)
515                 /* Skip the sideband designator if sideband is used */
516                 reader->line = reader->use_sideband ?
517                         reader->buffer + 1 : reader->buffer;
518         else
519                 reader->line = NULL;
520
521         return reader->status;
522 }
523
524 enum packet_read_status packet_reader_peek(struct packet_reader *reader)
525 {
526         /* Only allow peeking a single line */
527         if (reader->line_peeked)
528                 return reader->status;
529
530         /* Peek a line by reading it and setting peeked flag */
531         packet_reader_read(reader);
532         reader->line_peeked = 1;
533         return reader->status;
534 }
535
536 void packet_writer_init(struct packet_writer *writer, int dest_fd)
537 {
538         writer->dest_fd = dest_fd;
539         writer->use_sideband = 0;
540 }
541
542 void packet_writer_write(struct packet_writer *writer, const char *fmt, ...)
543 {
544         va_list args;
545
546         va_start(args, fmt);
547         packet_write_fmt_1(writer->dest_fd, 0,
548                            writer->use_sideband ? "\001" : "", fmt, args);
549         va_end(args);
550 }
551
552 void packet_writer_error(struct packet_writer *writer, const char *fmt, ...)
553 {
554         va_list args;
555
556         va_start(args, fmt);
557         packet_write_fmt_1(writer->dest_fd, 0,
558                            writer->use_sideband ? "\003" : "ERR ", fmt, args);
559         va_end(args);
560 }
561
562 void packet_writer_delim(struct packet_writer *writer)
563 {
564         packet_delim(writer->dest_fd);
565 }
566
567 void packet_writer_flush(struct packet_writer *writer)
568 {
569         packet_flush(writer->dest_fd);
570 }