?  search:
summary | log | graphiclog1 | graphiclog2 | commit | commitdiff | tree | refs | edit | fork
blame | history | raw | HEAD
Merge branch 'jk/initialization-fix-to-add-submodule-odb'
[git.git] / transport.c
blob23b2ed6f0cf6f521c4d5afa6c1cffe0786d29a5f
1 #include "cache.h"
2 #include "transport.h"
3 #include "run-command.h"
4 #include "pkt-line.h"
5 #include "fetch-pack.h"
6 #include "remote.h"
7 #include "connect.h"
8 #include "send-pack.h"
9 #include "walker.h"
10 #include "bundle.h"
11 #include "dir.h"
12 #include "refs.h"
13 #include "branch.h"
14 #include "url.h"
15 #include "submodule.h"
16 #include "string-list.h"
17 #include "sha1-array.h"
18
19 /* rsync support */
20
21 /*
22 * We copy packed-refs and refs/ into a temporary file, then read the
23 * loose refs recursively (sorting whenever possible), and then inserting
24 * those packed refs that are not yet in the list (not validating, but
25 * assuming that the file is sorted).
26 *
27 * Appears refactoring this from refs.c is too cumbersome.
28 */
29
30 static int str_cmp(const void *a, const void *b)
31 {
32 const char *s1 = a;
33 const char *s2 = b;
34
35 return strcmp(s1, s2);
36 }
37
38 /* path->buf + name_offset is expected to point to "refs/" */
39
40 static int read_loose_refs(struct strbuf *path, int name_offset,
41 struct ref **tail)
42 {
43 DIR *dir = opendir(path->buf);
44 struct dirent *de;
45 struct {
46 char **entries;
47 int nr, alloc;
48 } list;
49 int i, pathlen;
50
51 if (!dir)
52 return -1;
53
54 memset (&list, 0, sizeof(list));
55
56 while ((de = readdir(dir))) {
57 if (is_dot_or_dotdot(de->d_name))
58 continue;
59 ALLOC_GROW(list.entries, list.nr + 1, list.alloc);
60 list.entries[list.nr++] = xstrdup(de->d_name);
61 }
62 closedir(dir);
63
64 /* sort the list */
65
66 qsort(list.entries, list.nr, sizeof(char *), str_cmp);
67
68 pathlen = path->len;
69 strbuf_addch(path, '/');
70
71 for (i = 0; i < list.nr; i++, strbuf_setlen(path, pathlen + 1)) {
72 strbuf_addstr(path, list.entries[i]);
73 if (read_loose_refs(path, name_offset, tail)) {
74 int fd = open(path->buf, O_RDONLY);
75 char buffer[40];
76 struct ref *next;
77
78 if (fd < 0)
79 continue;
80 next = alloc_ref(path->buf + name_offset);
81 if (read_in_full(fd, buffer, 40) != 40 ||
82 get_sha1_hex(buffer, next->old_sha1)) {
83 close(fd);
84 free(next);
85 continue;
86 }
87 close(fd);
88 (*tail)->next = next;
89 *tail = next;
90 }
91 }
92 strbuf_setlen(path, pathlen);
93
94 for (i = 0; i < list.nr; i++)
95 free(list.entries[i]);
96 free(list.entries);
97
98 return 0;
99 }
100
101 /* insert the packed refs for which no loose refs were found */
102
103 static void insert_packed_refs(const char *packed_refs, struct ref **list)
104 {
105 FILE *f = fopen(packed_refs, "r");
106 static char buffer[PATH_MAX];
107
108 if (!f)
109 return;
110
111 for (;;) {
112 int cmp = 0; /* assigned before used */
113 int len;
114
115 if (!fgets(buffer, sizeof(buffer), f)) {
116 fclose(f);
117 return;
118 }
119
120 if (!isxdigit(buffer[0]))
121 continue;
122 len = strlen(buffer);
123 if (len && buffer[len - 1] == '\n')
124 buffer[--len] = '\0';
125 if (len < 41)
126 continue;
127 while ((*list)->next &&
128 (cmp = strcmp(buffer + 41,
129 (*list)->next->name)) > 0)
130 list = &(*list)->next;
131 if (!(*list)->next || cmp < 0) {
132 struct ref *next = alloc_ref(buffer + 41);
133 buffer[40] = '\0';
134 if (get_sha1_hex(buffer, next->old_sha1)) {
135 warning ("invalid SHA-1: %s", buffer);
136 free(next);
137 continue;
138 }
139 next->next = (*list)->next;
140 (*list)->next = next;
141 list = &(*list)->next;
142 }
143 }
144 }
145
146 static void set_upstreams(struct transport *transport, struct ref *refs,
147 int pretend)
148 {
149 struct ref *ref;
150 for (ref = refs; ref; ref = ref->next) {
151 const char *localname;
152 const char *tmp;
153 const char *remotename;
154 unsigned char sha[20];
155 int flag = 0;
156 /*
157 * Check suitability for tracking. Must be successful /
158 * already up-to-date ref create/modify (not delete).
159 */
160 if (ref->status != REF_STATUS_OK &&
161 ref->status != REF_STATUS_UPTODATE)
162 continue;
163 if (!ref->peer_ref)
164 continue;
165 if (is_null_sha1(ref->new_sha1))
166 continue;
167
168 /* Follow symbolic refs (mainly for HEAD). */
169 localname = ref->peer_ref->name;
170 remotename = ref->name;
171 tmp = resolve_ref_unsafe(localname, RESOLVE_REF_READING,
172 sha, &flag);
173 if (tmp && flag & REF_ISSYMREF &&
174 starts_with(tmp, "refs/heads/"))
175 localname = tmp;
176
177 /* Both source and destination must be local branches. */
178 if (!localname || !starts_with(localname, "refs/heads/"))
179 continue;
180 if (!remotename || !starts_with(remotename, "refs/heads/"))
181 continue;
182
183 if (!pretend)
184 install_branch_config(BRANCH_CONFIG_VERBOSE,
185 localname + 11, transport->remote->name,
186 remotename);
187 else
188 printf("Would set upstream of '%s' to '%s' of '%s'\n",
189 localname + 11, remotename + 11,
190 transport->remote->name);
191 }
192 }
193
194 static const char *rsync_url(const char *url)
195 {
196 if (!starts_with(url, "rsync://"))
197 skip_prefix(url, "rsync:", &url);
198 return url;
199 }
200
201 static struct ref *get_refs_via_rsync(struct transport *transport, int for_push)
202 {
203 struct strbuf buf = STRBUF_INIT, temp_dir = STRBUF_INIT;
204 struct ref dummy = {NULL}, *tail = &dummy;
205 struct child_process rsync = CHILD_PROCESS_INIT;
206 const char *args[5];
207 int temp_dir_len;
208
209 if (for_push)
210 return NULL;
211
212 /* copy the refs to the temporary directory */
213
214 strbuf_addstr(&temp_dir, git_path("rsync-refs-XXXXXX"));
215 if (!mkdtemp(temp_dir.buf))
216 die_errno ("Could not make temporary directory");
217 temp_dir_len = temp_dir.len;
218
219 strbuf_addstr(&buf, rsync_url(transport->url));
220 strbuf_addstr(&buf, "/refs");
221
222 rsync.argv = args;
223 rsync.stdout_to_stderr = 1;
224 args[0] = "rsync";
225 args[1] = (transport->verbose > 1) ? "-rv" : "-r";
226 args[2] = buf.buf;
227 args[3] = temp_dir.buf;
228 args[4] = NULL;
229
230 if (run_command(&rsync))
231 die ("Could not run rsync to get refs");
232
233 strbuf_reset(&buf);
234 strbuf_addstr(&buf, rsync_url(transport->url));
235 strbuf_addstr(&buf, "/packed-refs");
236
237 args[2] = buf.buf;
238
239 if (run_command(&rsync))
240 die ("Could not run rsync to get refs");
241
242 /* read the copied refs */
243
244 strbuf_addstr(&temp_dir, "/refs");
245 read_loose_refs(&temp_dir, temp_dir_len + 1, &tail);
246 strbuf_setlen(&temp_dir, temp_dir_len);
247
248 tail = &dummy;
249 strbuf_addstr(&temp_dir, "/packed-refs");
250 insert_packed_refs(temp_dir.buf, &tail);
251 strbuf_setlen(&temp_dir, temp_dir_len);
252
253 if (remove_dir_recursively(&temp_dir, 0))
254 warning ("Error removing temporary directory %s.",
255 temp_dir.buf);
256
257 strbuf_release(&buf);
258 strbuf_release(&temp_dir);
259
260 return dummy.next;
261 }
262
263 static int fetch_objs_via_rsync(struct transport *transport,
264 int nr_objs, struct ref **to_fetch)
265 {
266 struct child_process rsync = CHILD_PROCESS_INIT;
267
268 rsync.stdout_to_stderr = 1;
269 argv_array_push(&rsync.args, "rsync");
270 argv_array_push(&rsync.args, (transport->verbose > 1) ? "-rv" : "-r");
271 argv_array_push(&rsync.args, "--ignore-existing");
272 argv_array_push(&rsync.args, "--exclude");
273 argv_array_push(&rsync.args, "info");
274 argv_array_pushf(&rsync.args, "%s/objects/", rsync_url(transport->url));
275 argv_array_push(&rsync.args, get_object_directory());
276
277 /* NEEDSWORK: handle one level of alternates */
278 return run_command(&rsync);
279 }
280
281 static int write_one_ref(const char *name, const struct object_id *oid,
282 int flags, void *data)
283 {
284 struct strbuf *buf = data;
285 int len = buf->len;
286
287 /* when called via for_each_ref(), flags is non-zero */
288 if (flags && !starts_with(name, "refs/heads/") &&
289 !starts_with(name, "refs/tags/"))
290 return 0;
291
292 strbuf_addstr(buf, name);
293 if (safe_create_leading_directories(buf->buf) ||
294 write_file_gently(buf->buf, "%s", oid_to_hex(oid)))
295 return error("problems writing temporary file %s: %s",
296 buf->buf, strerror(errno));
297 strbuf_setlen(buf, len);
298 return 0;
299 }
300
301 static int write_refs_to_temp_dir(struct strbuf *temp_dir,
302 int refspec_nr, const char **refspec)
303 {
304 int i;
305
306 for (i = 0; i < refspec_nr; i++) {
307 struct object_id oid;
308 char *ref;
309
310 if (dwim_ref(refspec[i], strlen(refspec[i]), oid.hash, &ref) != 1)
311 return error("Could not get ref %s", refspec[i]);
312
313 if (write_one_ref(ref, &oid, 0, temp_dir)) {
314 free(ref);
315 return -1;
316 }
317 free(ref);
318 }
319 return 0;
320 }
321
322 static int rsync_transport_push(struct transport *transport,
323 int refspec_nr, const char **refspec, int flags)
324 {
325 struct strbuf buf = STRBUF_INIT, temp_dir = STRBUF_INIT;
326 int result = 0, i;
327 struct child_process rsync = CHILD_PROCESS_INIT;
328 const char *args[10];
329
330 if (flags & TRANSPORT_PUSH_MIRROR)
331 return error("rsync transport does not support mirror mode");
332
333 /* first push the objects */
334
335 strbuf_addstr(&buf, rsync_url(transport->url));
336 strbuf_addch(&buf, '/');
337
338 rsync.argv = args;
339 rsync.stdout_to_stderr = 1;
340 i = 0;
341 args[i++] = "rsync";
342 args[i++] = "-a";
343 if (flags & TRANSPORT_PUSH_DRY_RUN)
344 args[i++] = "--dry-run";
345 if (transport->verbose > 1)
346 args[i++] = "-v";
347 args[i++] = "--ignore-existing";
348 args[i++] = "--exclude";
349 args[i++] = "info";
350 args[i++] = get_object_directory();
351 args[i++] = buf.buf;
352 args[i++] = NULL;
353
354 if (run_command(&rsync))
355 return error("Could not push objects to %s",
356 rsync_url(transport->url));
357
358 /* copy the refs to the temporary directory; they could be packed. */
359
360 strbuf_addstr(&temp_dir, git_path("rsync-refs-XXXXXX"));
361 if (!mkdtemp(temp_dir.buf))
362 die_errno ("Could not make temporary directory");
363 strbuf_addch(&temp_dir, '/');
364
365 if (flags & TRANSPORT_PUSH_ALL) {
366 if (for_each_ref(write_one_ref, &temp_dir))
367 return -1;
368 } else if (write_refs_to_temp_dir(&temp_dir, refspec_nr, refspec))
369 return -1;
370
371 i = 2;
372 if (flags & TRANSPORT_PUSH_DRY_RUN)
373 args[i++] = "--dry-run";
374 if (!(flags & TRANSPORT_PUSH_FORCE))
375 args[i++] = "--ignore-existing";
376 args[i++] = temp_dir.buf;
377 args[i++] = rsync_url(transport->url);
378 args[i++] = NULL;
379 if (run_command(&rsync))
380 result = error("Could not push to %s",
381 rsync_url(transport->url));
382
383 if (remove_dir_recursively(&temp_dir, 0))
384 warning ("Could not remove temporary directory %s.",
385 temp_dir.buf);
386
387 strbuf_release(&buf);
388 strbuf_release(&temp_dir);
389
390 return result;
391 }
392
393 struct bundle_transport_data {
394 int fd;
395 struct bundle_header header;
396 };
397
398 static struct ref *get_refs_from_bundle(struct transport *transport, int for_push)
399 {
400 struct bundle_transport_data *data = transport->data;
401 struct ref *result = NULL;
402 int i;
403
404 if (for_push)
405 return NULL;
406
407 if (data->fd > 0)
408 close(data->fd);
409 data->fd = read_bundle_header(transport->url, &data->header);
410 if (data->fd < 0)
411 die ("Could not read bundle '%s'.", transport->url);
412 for (i = 0; i < data->header.references.nr; i++) {
413 struct ref_list_entry *e = data->header.references.list + i;
414 struct ref *ref = alloc_ref(e->name);
415 hashcpy(ref->old_sha1, e->sha1);
416 ref->next = result;
417 result = ref;
418 }
419 return result;
420 }
421
422 static int fetch_refs_from_bundle(struct transport *transport,
423 int nr_heads, struct ref **to_fetch)
424 {
425 struct bundle_transport_data *data = transport->data;
426 return unbundle(&data->header, data->fd,
427 transport->progress ? BUNDLE_VERBOSE : 0);
428 }
429
430 static int close_bundle(struct transport *transport)
431 {
432 struct bundle_transport_data *data = transport->data;
433 if (data->fd > 0)
434 close(data->fd);
435 free(data);
436 return 0;
437 }
438
439 struct git_transport_data {
440 struct git_transport_options options;
441 struct child_process *conn;
442 int fd[2];
443 unsigned got_remote_heads : 1;
444 struct sha1_array extra_have;
445 struct sha1_array shallow;
446 };
447
448 static int set_git_option(struct git_transport_options *opts,
449 const char *name, const char *value)
450 {
451 if (!strcmp(name, TRANS_OPT_UPLOADPACK)) {
452 opts->uploadpack = value;
453 return 0;
454 } else if (!strcmp(name, TRANS_OPT_RECEIVEPACK)) {
455 opts->receivepack = value;
456 return 0;
457 } else if (!strcmp(name, TRANS_OPT_THIN)) {
458 opts->thin = !!value;
459 return 0;
460 } else if (!strcmp(name, TRANS_OPT_FOLLOWTAGS)) {
461 opts->followtags = !!value;
462 return 0;
463 } else if (!strcmp(name, TRANS_OPT_KEEP)) {
464 opts->keep = !!value;
465 return 0;
466 } else if (!strcmp(name, TRANS_OPT_UPDATE_SHALLOW)) {
467 opts->update_shallow = !!value;
468 return 0;
469 } else if (!strcmp(name, TRANS_OPT_DEPTH)) {
470 if (!value)
471 opts->depth = 0;
472 else {
473 char *end;
474 opts->depth = strtol(value, &end, 0);
475 if (*end)
476 die("transport: invalid depth option '%s'", value);
477 }
478 return 0;
479 }
480 return 1;
481 }
482
483 static int connect_setup(struct transport *transport, int for_push, int verbose)
484 {
485 struct git_transport_data *data = transport->data;
486
487 if (data->conn)
488 return 0;
489
490 data->conn = git_connect(data->fd, transport->url,
491 for_push ? data->options.receivepack :
492 data->options.uploadpack,
493 verbose ? CONNECT_VERBOSE : 0);
494
495 return 0;
496 }
497
498 static struct ref *get_refs_via_connect(struct transport *transport, int for_push)
499 {
500 struct git_transport_data *data = transport->data;
501 struct ref *refs;
502
503 connect_setup(transport, for_push, 0);
504 get_remote_heads(data->fd[0], NULL, 0, &refs,
505 for_push ? REF_NORMAL : 0,
506 &data->extra_have,
507 &data->shallow);
508 data->got_remote_heads = 1;
509
510 return refs;
511 }
512
513 static int fetch_refs_via_pack(struct transport *transport,
514 int nr_heads, struct ref **to_fetch)
515 {
516 struct git_transport_data *data = transport->data;
517 struct ref *refs;
518 char *dest = xstrdup(transport->url);
519 struct fetch_pack_args args;
520 struct ref *refs_tmp = NULL;
521
522 memset(&args, 0, sizeof(args));
523 args.uploadpack = data->options.uploadpack;
524 args.keep_pack = data->options.keep;
525 args.lock_pack = 1;
526 args.use_thin_pack = data->options.thin;
527 args.include_tag = data->options.followtags;
528 args.verbose = (transport->verbose > 1);
529 args.quiet = (transport->verbose < 0);
530 args.no_progress = !transport->progress;
531 args.depth = data->options.depth;
532 args.check_self_contained_and_connected =
533 data->options.check_self_contained_and_connected;
534 args.cloning = transport->cloning;
535 args.update_shallow = data->options.update_shallow;
536
537 if (!data->got_remote_heads) {
538 connect_setup(transport, 0, 0);
539 get_remote_heads(data->fd[0], NULL, 0, &refs_tmp, 0,
540 NULL, &data->shallow);
541 data->got_remote_heads = 1;
542 }
543
544 refs = fetch_pack(&args, data->fd, data->conn,
545 refs_tmp ? refs_tmp : transport->remote_refs,
546 dest, to_fetch, nr_heads, &data->shallow,
547 &transport->pack_lockfile);
548 close(data->fd[0]);
549 close(data->fd[1]);
550 if (finish_connect(data->conn)) {
551 free_refs(refs);
552 refs = NULL;
553 }
554 data->conn = NULL;
555 data->got_remote_heads = 0;
556 data->options.self_contained_and_connected =
557 args.self_contained_and_connected;
558
559 free_refs(refs_tmp);
560 free_refs(refs);
561 free(dest);
562 return (refs ? 0 : -1);
563 }
564
565 static int push_had_errors(struct ref *ref)
566 {
567 for (; ref; ref = ref->next) {
568 switch (ref->status) {
569 case REF_STATUS_NONE:
570 case REF_STATUS_UPTODATE:
571 case REF_STATUS_OK:
572 break;
573 default:
574 return 1;
575 }
576 }
577 return 0;
578 }
579
580 int transport_refs_pushed(struct ref *ref)
581 {
582 for (; ref; ref = ref->next) {
583 switch(ref->status) {
584 case REF_STATUS_NONE:
585 case REF_STATUS_UPTODATE:
586 break;
587 default:
588 return 1;
589 }
590 }
591 return 0;
592 }
593
594 void transport_update_tracking_ref(struct remote *remote, struct ref *ref, int verbose)
595 {
596 struct refspec rs;
597
598 if (ref->status != REF_STATUS_OK && ref->status != REF_STATUS_UPTODATE)
599 return;
600
601 rs.src = ref->name;
602 rs.dst = NULL;
603
604 if (!remote_find_tracking(remote, &rs)) {
605 if (verbose)
606 fprintf(stderr, "updating local tracking ref '%s'\n", rs.dst);
607 if (ref->deletion) {
608 delete_ref(rs.dst, NULL, 0);
609 } else
610 update_ref("update by push", rs.dst,
611 ref->new_sha1, NULL, 0, 0);
612 free(rs.dst);
613 }
614 }
615
616 static void print_ref_status(char flag, const char *summary, struct ref *to, struct ref *from, const char *msg, int porcelain)
617 {
618 if (porcelain) {
619 if (from)
620 fprintf(stdout, "%c\t%s:%s\t", flag, from->name, to->name);
621 else
622 fprintf(stdout, "%c\t:%s\t", flag, to->name);
623 if (msg)
624 fprintf(stdout, "%s (%s)\n", summary, msg);
625 else
626 fprintf(stdout, "%s\n", summary);
627 } else {
628 fprintf(stderr, " %c %-*s ", flag, TRANSPORT_SUMMARY_WIDTH, summary);
629 if (from)
630 fprintf(stderr, "%s -> %s", prettify_refname(from->name), prettify_refname(to->name));
631 else
632 fputs(prettify_refname(to->name), stderr);
633 if (msg) {
634 fputs(" (", stderr);
635 fputs(msg, stderr);
636 fputc(')', stderr);
637 }
638 fputc('\n', stderr);
639 }
640 }
641
642 static const char *status_abbrev(unsigned char sha1[20])
643 {
644 return find_unique_abbrev(sha1, DEFAULT_ABBREV);
645 }
646
647 static void print_ok_ref_status(struct ref *ref, int porcelain)
648 {
649 if (ref->deletion)
650 print_ref_status('-', "[deleted]", ref, NULL, NULL, porcelain);
651 else if (is_null_sha1(ref->old_sha1))
652 print_ref_status('*',
653 (starts_with(ref->name, "refs/tags/") ? "[new tag]" :
654 "[new branch]"),
655 ref, ref->peer_ref, NULL, porcelain);
656 else {
657 struct strbuf quickref = STRBUF_INIT;
658 char type;
659 const char *msg;
660
661 strbuf_addstr(&quickref, status_abbrev(ref->old_sha1));
662 if (ref->forced_update) {
663 strbuf_addstr(&quickref, "...");
664 type = '+';
665 msg = "forced update";
666 } else {
667 strbuf_addstr(&quickref, "..");
668 type = ' ';
669 msg = NULL;
670 }
671 strbuf_addstr(&quickref, status_abbrev(ref->new_sha1));
672
673 print_ref_status(type, quickref.buf, ref, ref->peer_ref, msg, porcelain);
674 strbuf_release(&quickref);
675 }
676 }
677
678 static int print_one_push_status(struct ref *ref, const char *dest, int count, int porcelain)
679 {
680 if (!count)
681 fprintf(porcelain ? stdout : stderr, "To %s\n", dest);
682
683 switch(ref->status) {
684 case REF_STATUS_NONE:
685 print_ref_status('X', "[no match]", ref, NULL, NULL, porcelain);
686 break;
687 case REF_STATUS_REJECT_NODELETE:
688 print_ref_status('!', "[rejected]", ref, NULL,
689 "remote does not support deleting refs", porcelain);
690 break;
691 case REF_STATUS_UPTODATE:
692 print_ref_status('=', "[up to date]", ref,
693 ref->peer_ref, NULL, porcelain);
694 break;
695 case REF_STATUS_REJECT_NONFASTFORWARD:
696 print_ref_status('!', "[rejected]", ref, ref->peer_ref,
697 "non-fast-forward", porcelain);
698 break;
699 case REF_STATUS_REJECT_ALREADY_EXISTS:
700 print_ref_status('!', "[rejected]", ref, ref->peer_ref,
701 "already exists", porcelain);
702 break;
703 case REF_STATUS_REJECT_FETCH_FIRST:
704 print_ref_status('!', "[rejected]", ref, ref->peer_ref,
705 "fetch first", porcelain);
706 break;
707 case REF_STATUS_REJECT_NEEDS_FORCE:
708 print_ref_status('!', "[rejected]", ref, ref->peer_ref,
709 "needs force", porcelain);
710 break;
711 case REF_STATUS_REJECT_STALE:
712 print_ref_status('!', "[rejected]", ref, ref->peer_ref,
713 "stale info", porcelain);
714 break;
715 case REF_STATUS_REJECT_SHALLOW:
716 print_ref_status('!', "[rejected]", ref, ref->peer_ref,
717 "new shallow roots not allowed", porcelain);
718 break;
719 case REF_STATUS_REMOTE_REJECT:
720 print_ref_status('!', "[remote rejected]", ref,
721 ref->deletion ? NULL : ref->peer_ref,
722 ref->remote_status, porcelain);
723 break;
724 case REF_STATUS_EXPECTING_REPORT:
725 print_ref_status('!', "[remote failure]", ref,
726 ref->deletion ? NULL : ref->peer_ref,
727 "remote failed to report status", porcelain);
728 break;
729 case REF_STATUS_ATOMIC_PUSH_FAILED:
730 print_ref_status('!', "[rejected]", ref, ref->peer_ref,
731 "atomic push failed", porcelain);
732 break;
733 case REF_STATUS_OK:
734 print_ok_ref_status(ref, porcelain);
735 break;
736 }
737
738 return 1;
739 }
740
741 void transport_print_push_status(const char *dest, struct ref *refs,
742 int verbose, int porcelain, unsigned int *reject_reasons)
743 {
744 struct ref *ref;
745 int n = 0;
746 unsigned char head_sha1[20];
747 char *head;
748
749 head = resolve_refdup("HEAD", RESOLVE_REF_READING, head_sha1, NULL);
750
751 if (verbose) {
752 for (ref = refs; ref; ref = ref->next)
753 if (ref->status == REF_STATUS_UPTODATE)
754 n += print_one_push_status(ref, dest, n, porcelain);
755 }
756
757 for (ref = refs; ref; ref = ref->next)
758 if (ref->status == REF_STATUS_OK)
759 n += print_one_push_status(ref, dest, n, porcelain);
760
761 *reject_reasons = 0;
762 for (ref = refs; ref; ref = ref->next) {
763 if (ref->status != REF_STATUS_NONE &&
764 ref->status != REF_STATUS_UPTODATE &&
765 ref->status != REF_STATUS_OK)
766 n += print_one_push_status(ref, dest, n, porcelain);
767 if (ref->status == REF_STATUS_REJECT_NONFASTFORWARD) {
768 if (head != NULL && !strcmp(head, ref->name))
769 *reject_reasons |= REJECT_NON_FF_HEAD;
770 else
771 *reject_reasons |= REJECT_NON_FF_OTHER;
772 } else if (ref->status == REF_STATUS_REJECT_ALREADY_EXISTS) {
773 *reject_reasons |= REJECT_ALREADY_EXISTS;
774 } else if (ref->status == REF_STATUS_REJECT_FETCH_FIRST) {
775 *reject_reasons |= REJECT_FETCH_FIRST;
776 } else if (ref->status == REF_STATUS_REJECT_NEEDS_FORCE) {
777 *reject_reasons |= REJECT_NEEDS_FORCE;
778 }
779 }
780 free(head);
781 }
782
783 void transport_verify_remote_names(int nr_heads, const char **heads)
784 {
785 int i;
786
787 for (i = 0; i < nr_heads; i++) {
788 const char *local = heads[i];
789 const char *remote = strrchr(heads[i], ':');
790
791 if (*local == '+')
792 local++;
793
794 /* A matching refspec is okay. */
795 if (remote == local && remote[1] == '\0')
796 continue;
797
798 remote = remote ? (remote + 1) : local;
799 if (check_refname_format(remote,
800 REFNAME_ALLOW_ONELEVEL|REFNAME_REFSPEC_PATTERN))
801 die("remote part of refspec is not a valid name in %s",
802 heads[i]);
803 }
804 }
805
806 static int git_transport_push(struct transport *transport, struct ref *remote_refs, int flags)
807 {
808 struct git_transport_data *data = transport->data;
809 struct send_pack_args args;
810 int ret;
811
812 if (!data->got_remote_heads) {
813 struct ref *tmp_refs;
814 connect_setup(transport, 1, 0);
815
816 get_remote_heads(data->fd[0], NULL, 0, &tmp_refs, REF_NORMAL,
817 NULL, &data->shallow);
818 data->got_remote_heads = 1;
819 }
820
821 memset(&args, 0, sizeof(args));
822 args.send_mirror = !!(flags & TRANSPORT_PUSH_MIRROR);
823 args.force_update = !!(flags & TRANSPORT_PUSH_FORCE);
824 args.use_thin_pack = data->options.thin;
825 args.verbose = (transport->verbose > 0);
826 args.quiet = (transport->verbose < 0);
827 args.progress = transport->progress;
828 args.dry_run = !!(flags & TRANSPORT_PUSH_DRY_RUN);
829 args.porcelain = !!(flags & TRANSPORT_PUSH_PORCELAIN);
830 args.atomic = !!(flags & TRANSPORT_PUSH_ATOMIC);
831 args.url = transport->url;
832
833 if (flags & TRANSPORT_PUSH_CERT_ALWAYS)
834 args.push_cert = SEND_PACK_PUSH_CERT_ALWAYS;
835 else if (flags & TRANSPORT_PUSH_CERT_IF_ASKED)
836 args.push_cert = SEND_PACK_PUSH_CERT_IF_ASKED;
837 else
838 args.push_cert = SEND_PACK_PUSH_CERT_NEVER;
839
840 ret = send_pack(&args, data->fd, data->conn, remote_refs,
841 &data->extra_have);
842
843 close(data->fd[1]);
844 close(data->fd[0]);
845 ret |= finish_connect(data->conn);
846 data->conn = NULL;
847 data->got_remote_heads = 0;
848
849 return ret;
850 }
851
852 static int connect_git(struct transport *transport, const char *name,
853 const char *executable, int fd[2])
854 {
855 struct git_transport_data *data = transport->data;
856 data->conn = git_connect(data->fd, transport->url,
857 executable, 0);
858 fd[0] = data->fd[0];
859 fd[1] = data->fd[1];
860 return 0;
861 }
862
863 static int disconnect_git(struct transport *transport)
864 {
865 struct git_transport_data *data = transport->data;
866 if (data->conn) {
867 if (data->got_remote_heads)
868 packet_flush(data->fd[1]);
869 close(data->fd[0]);
870 close(data->fd[1]);
871 finish_connect(data->conn);
872 }
873
874 free(data);
875 return 0;
876 }
877
878 void transport_take_over(struct transport *transport,
879 struct child_process *child)
880 {
881 struct git_transport_data *data;
882
883 if (!transport->smart_options)
884 die("Bug detected: Taking over transport requires non-NULL "
885 "smart_options field.");
886
887 data = xcalloc(1, sizeof(*data));
888 data->options = *transport->smart_options;
889 data->conn = child;
890 data->fd[0] = data->conn->out;
891 data->fd[1] = data->conn->in;
892 data->got_remote_heads = 0;
893 transport->data = data;
894
895 transport->set_option = NULL;
896 transport->get_refs_list = get_refs_via_connect;
897 transport->fetch = fetch_refs_via_pack;
898 transport->push = NULL;
899 transport->push_refs = git_transport_push;
900 transport->disconnect = disconnect_git;
901 transport->smart_options = &(data->options);
902
903 transport->cannot_reuse = 1;
904 }
905
906 static int is_file(const char *url)
907 {
908 struct stat buf;
909 if (stat(url, &buf))
910 return 0;
911 return S_ISREG(buf.st_mode);
912 }
913
914 static int external_specification_len(const char *url)
915 {
916 return strchr(url, ':') - url;
917 }
918
919 static const struct string_list *protocol_whitelist(void)
920 {
921 static int enabled = -1;
922 static struct string_list allowed = STRING_LIST_INIT_DUP;
923
924 if (enabled < 0) {
925 const char *v = getenv("GIT_ALLOW_PROTOCOL");
926 if (v) {
927 string_list_split(&allowed, v, ':', -1);
928 string_list_sort(&allowed);
929 enabled = 1;
930 } else {
931 enabled = 0;
932 }
933 }
934
935 return enabled ? &allowed : NULL;
936 }
937
938 int is_transport_allowed(const char *type)
939 {
940 const struct string_list *allowed = protocol_whitelist();
941 return !allowed || string_list_has_string(allowed, type);
942 }
943
944 void transport_check_allowed(const char *type)
945 {
946 if (!is_transport_allowed(type))
947 die("transport '%s' not allowed", type);
948 }
949
950 int transport_restrict_protocols(void)
951 {
952 return !!protocol_whitelist();
953 }
954
955 struct transport *transport_get(struct remote *remote, const char *url)
956 {
957 const char *helper;
958 struct transport *ret = xcalloc(1, sizeof(*ret));
959
960 ret->progress = isatty(2);
961
962 if (!remote)
963 die("No remote provided to transport_get()");
964
965 ret->got_remote_refs = 0;
966 ret->remote = remote;
967 helper = remote->foreign_vcs;
968
969 if (!url && remote->url)
970 url = remote->url[0];
971 ret->url = url;
972
973 /* maybe it is a foreign URL? */
974 if (url) {
975 const char *p = url;
976
977 while (is_urlschemechar(p == url, *p))
978 p++;
979 if (starts_with(p, "::"))
980 helper = xstrndup(url, p - url);
981 }
982
983 if (helper) {
984 transport_helper_init(ret, helper);
985 } else if (starts_with(url, "rsync:")) {
986 transport_check_allowed("rsync");
987 ret->get_refs_list = get_refs_via_rsync;
988 ret->fetch = fetch_objs_via_rsync;
989 ret->push = rsync_transport_push;
990 ret->smart_options = NULL;
991 } else if (url_is_local_not_ssh(url) && is_file(url) && is_bundle(url, 1)) {
992 struct bundle_transport_data *data = xcalloc(1, sizeof(*data));
993 transport_check_allowed("file");
994 ret->data = data;
995 ret->get_refs_list = get_refs_from_bundle;
996 ret->fetch = fetch_refs_from_bundle;
997 ret->disconnect = close_bundle;
998 ret->smart_options = NULL;
999 } else if (!is_url(url)
1000 || starts_with(url, "file://")
1001 || starts_with(url, "git://")
1002 || starts_with(url, "ssh://")
1003 || starts_with(url, "git+ssh://")
1004 || starts_with(url, "ssh+git://")) {
1005 /*
1006 * These are builtin smart transports; "allowed" transports
1007 * will be checked individually in git_connect.
1008 */
1009 struct git_transport_data *data = xcalloc(1, sizeof(*data));
1010 ret->data = data;
1011 ret->set_option = NULL;
1012 ret->get_refs_list = get_refs_via_connect;
1013 ret->fetch = fetch_refs_via_pack;
1014 ret->push_refs = git_transport_push;
1015 ret->connect = connect_git;
1016 ret->disconnect = disconnect_git;
1017 ret->smart_options = &(data->options);
1018
1019 data->conn = NULL;
1020 data->got_remote_heads = 0;
1021 } else {
1022 /* Unknown protocol in URL. Pass to external handler. */
1023 int len = external_specification_len(url);
1024 char *handler = xmemdupz(url, len);
1025 transport_helper_init(ret, handler);
1026 }
1027
1028 if (ret->smart_options) {
1029 ret->smart_options->thin = 1;
1030 ret->smart_options->uploadpack = "git-upload-pack";
1031 if (remote->uploadpack)
1032 ret->smart_options->uploadpack = remote->uploadpack;
1033 ret->smart_options->receivepack = "git-receive-pack";
1034 if (remote->receivepack)
1035 ret->smart_options->receivepack = remote->receivepack;
1036 }
1037
1038 return ret;
1039 }
1040
1041 int transport_set_option(struct transport *transport,
1042 const char *name, const char *value)
1043 {
1044 int git_reports = 1, protocol_reports = 1;
1045
1046 if (transport->smart_options)
1047 git_reports = set_git_option(transport->smart_options,
1048 name, value);
1049
1050 if (transport->set_option)
1051 protocol_reports = transport->set_option(transport, name,
1052 value);
1053
1054 /* If either report is 0, report 0 (success). */
1055 if (!git_reports || !protocol_reports)
1056 return 0;
1057 /* If either reports -1 (invalid value), report -1. */
1058 if ((git_reports == -1) || (protocol_reports == -1))
1059 return -1;
1060 /* Otherwise if both report unknown, report unknown. */
1061 return 1;
1062 }
1063
1064 void transport_set_verbosity(struct transport *transport, int verbosity,
1065 int force_progress)
1066 {
1067 if (verbosity >= 1)
1068 transport->verbose = verbosity <= 3 ? verbosity : 3;
1069 if (verbosity < 0)
1070 transport->verbose = -1;
1071
1072 /**
1073 * Rules used to determine whether to report progress (processing aborts
1074 * when a rule is satisfied):
1075 *
1076 * . Report progress, if force_progress is 1 (ie. --progress).
1077 * . Don't report progress, if force_progress is 0 (ie. --no-progress).
1078 * . Don't report progress, if verbosity < 0 (ie. -q/--quiet ).
1079 * . Report progress if isatty(2) is 1.
1080 **/
1081 if (force_progress >= 0)
1082 transport->progress = !!force_progress;
1083 else
1084 transport->progress = verbosity >= 0 && isatty(2);
1085 }
1086
1087 static void die_with_unpushed_submodules(struct string_list *needs_pushing)
1088 {
1089 int i;
1090
1091 fprintf(stderr, "The following submodule paths contain changes that can\n"
1092 "not be found on any remote:\n");
1093 for (i = 0; i < needs_pushing->nr; i++)
1094 printf(" %s\n", needs_pushing->items[i].string);
1095 fprintf(stderr, "\nPlease try\n\n"
1096 " git push --recurse-submodules=on-demand\n\n"
1097 "or cd to the path and use\n\n"
1098 " git push\n\n"
1099 "to push them to a remote.\n\n");
1100
1101 string_list_clear(needs_pushing, 0);
1102
1103 die("Aborting.");
1104 }
1105
1106 static int run_pre_push_hook(struct transport *transport,
1107 struct ref *remote_refs)
1108 {
1109 int ret = 0, x;
1110 struct ref *r;
1111 struct child_process proc = CHILD_PROCESS_INIT;
1112 struct strbuf buf;
1113 const char *argv[4];
1114
1115 if (!(argv[0] = find_hook("pre-push")))
1116 return 0;
1117
1118 argv[1] = transport->remote->name;
1119 argv[2] = transport->url;
1120 argv[3] = NULL;
1121
1122 proc.argv = argv;
1123 proc.in = -1;
1124
1125 if (start_command(&proc)) {
1126 finish_command(&proc);
1127 return -1;
1128 }
1129
1130 strbuf_init(&buf, 256);
1131
1132 for (r = remote_refs; r; r = r->next) {
1133 if (!r->peer_ref) continue;
1134 if (r->status == REF_STATUS_REJECT_NONFASTFORWARD) continue;
1135 if (r->status == REF_STATUS_REJECT_STALE) continue;
1136 if (r->status == REF_STATUS_UPTODATE) continue;
1137
1138 strbuf_reset(&buf);
1139 strbuf_addf( &buf, "%s %s %s %s\n",
1140 r->peer_ref->name, sha1_to_hex(r->new_sha1),
1141 r->name, sha1_to_hex(r->old_sha1));
1142
1143 if (write_in_full(proc.in, buf.buf, buf.len) != buf.len) {
1144 ret = -1;
1145 break;
1146 }
1147 }
1148
1149 strbuf_release(&buf);
1150
1151 x = close(proc.in);
1152 if (!ret)
1153 ret = x;
1154
1155 x = finish_command(&proc);
1156 if (!ret)
1157 ret = x;
1158
1159 return ret;
1160 }
1161
1162 int transport_push(struct transport *transport,
1163 int refspec_nr, const char **refspec, int flags,
1164 unsigned int *reject_reasons)
1165 {
1166 *reject_reasons = 0;
1167 transport_verify_remote_names(refspec_nr, refspec);
1168
1169 if (transport->push) {
1170 /* Maybe FIXME. But no important transport uses this case. */
1171 if (flags & TRANSPORT_PUSH_SET_UPSTREAM)
1172 die("This transport does not support using --set-upstream");
1173
1174 return transport->push(transport, refspec_nr, refspec, flags);
1175 } else if (transport->push_refs) {
1176 struct ref *remote_refs;
1177 struct ref *local_refs = get_local_heads();
1178 int match_flags = MATCH_REFS_NONE;
1179 int verbose = (transport->verbose > 0);
1180 int quiet = (transport->verbose < 0);
1181 int porcelain = flags & TRANSPORT_PUSH_PORCELAIN;
1182 int pretend = flags & TRANSPORT_PUSH_DRY_RUN;
1183 int push_ret, ret, err;
1184
1185 if (check_push_refs(local_refs, refspec_nr, refspec) < 0)
1186 return -1;
1187
1188 remote_refs = transport->get_refs_list(transport, 1);
1189
1190 if (flags & TRANSPORT_PUSH_ALL)
1191 match_flags |= MATCH_REFS_ALL;
1192 if (flags & TRANSPORT_PUSH_MIRROR)
1193 match_flags |= MATCH_REFS_MIRROR;
1194 if (flags & TRANSPORT_PUSH_PRUNE)
1195 match_flags |= MATCH_REFS_PRUNE;
1196 if (flags & TRANSPORT_PUSH_FOLLOW_TAGS)
1197 match_flags |= MATCH_REFS_FOLLOW_TAGS;
1198
1199 if (match_push_refs(local_refs, &remote_refs,
1200 refspec_nr, refspec, match_flags)) {
1201 return -1;
1202 }
1203
1204 if (transport->smart_options &&
1205 transport->smart_options->cas &&
1206 !is_empty_cas(transport->smart_options->cas))
1207 apply_push_cas(transport->smart_options->cas,
1208 transport->remote, remote_refs);
1209
1210 set_ref_status_for_push(remote_refs,
1211 flags & TRANSPORT_PUSH_MIRROR,
1212 flags & TRANSPORT_PUSH_FORCE);
1213
1214 if (!(flags & TRANSPORT_PUSH_NO_HOOK))
1215 if (run_pre_push_hook(transport, remote_refs))
1216 return -1;
1217
1218 if ((flags & TRANSPORT_RECURSE_SUBMODULES_ON_DEMAND) && !is_bare_repository()) {
1219 struct ref *ref = remote_refs;
1220 for (; ref; ref = ref->next)
1221 if (!is_null_sha1(ref->new_sha1) &&
1222 !push_unpushed_submodules(ref->new_sha1,
1223 transport->remote->name))
1224 die ("Failed to push all needed submodules!");
1225 }
1226
1227 if ((flags & (TRANSPORT_RECURSE_SUBMODULES_ON_DEMAND |
1228 TRANSPORT_RECURSE_SUBMODULES_CHECK)) && !is_bare_repository()) {
1229 struct ref *ref = remote_refs;
1230 struct string_list needs_pushing = STRING_LIST_INIT_DUP;
1231
1232 for (; ref; ref = ref->next)
1233 if (!is_null_sha1(ref->new_sha1) &&
1234 find_unpushed_submodules(ref->new_sha1,
1235 transport->remote->name, &needs_pushing))
1236 die_with_unpushed_submodules(&needs_pushing);
1237 }
1238
1239 push_ret = transport->push_refs(transport, remote_refs, flags);
1240 err = push_had_errors(remote_refs);
1241 ret = push_ret | err;
1242
1243 if (!quiet || err)
1244 transport_print_push_status(transport->url, remote_refs,
1245 verbose | porcelain, porcelain,
1246 reject_reasons);
1247
1248 if (flags & TRANSPORT_PUSH_SET_UPSTREAM)
1249 set_upstreams(transport, remote_refs, pretend);
1250
1251 if (!(flags & TRANSPORT_PUSH_DRY_RUN)) {
1252 struct ref *ref;
1253 for (ref = remote_refs; ref; ref = ref->next)
1254 transport_update_tracking_ref(transport->remote, ref, verbose);
1255 }
1256
1257 if (porcelain && !push_ret)
1258 puts("Done");
1259 else if (!quiet && !ret && !transport_refs_pushed(remote_refs))
1260 fprintf(stderr, "Everything up-to-date\n");
1261
1262 return ret;
1263 }
1264 return 1;
1265 }
1266
1267 const struct ref *transport_get_remote_refs(struct transport *transport)
1268 {
1269 if (!transport->got_remote_refs) {
1270 transport->remote_refs = transport->get_refs_list(transport, 0);
1271 transport->got_remote_refs = 1;
1272 }
1273
1274 return transport->remote_refs;
1275 }
1276
1277 int transport_fetch_refs(struct transport *transport, struct ref *refs)
1278 {
1279 int rc;
1280 int nr_heads = 0, nr_alloc = 0, nr_refs = 0;
1281 struct ref **heads = NULL;
1282 struct ref *rm;
1283
1284 for (rm = refs; rm; rm = rm->next) {
1285 nr_refs++;
1286 if (rm->peer_ref &&
1287 !is_null_sha1(rm->old_sha1) &&
1288 !hashcmp(rm->peer_ref->old_sha1, rm->old_sha1))
1289 continue;
1290 ALLOC_GROW(heads, nr_heads + 1, nr_alloc);
1291 heads[nr_heads++] = rm;
1292 }
1293
1294 if (!nr_heads) {
1295 /*
1296 * When deepening of a shallow repository is requested,
1297 * then local and remote refs are likely to still be equal.
1298 * Just feed them all to the fetch method in that case.
1299 * This condition shouldn't be met in a non-deepening fetch
1300 * (see builtin/fetch.c:quickfetch()).
1301 */
1302 heads = xmalloc(nr_refs * sizeof(*heads));
1303 for (rm = refs; rm; rm = rm->next)
1304 heads[nr_heads++] = rm;
1305 }
1306
1307 rc = transport->fetch(transport, nr_heads, heads);
1308
1309 free(heads);
1310 return rc;
1311 }
1312
1313 void transport_unlock_pack(struct transport *transport)
1314 {
1315 if (transport->pack_lockfile) {
1316 unlink_or_warn(transport->pack_lockfile);
1317 free(transport->pack_lockfile);
1318 transport->pack_lockfile = NULL;
1319 }
1320 }
1321
1322 int transport_connect(struct transport *transport, const char *name,
1323 const char *exec, int fd[2])
1324 {
1325 if (transport->connect)
1326 return transport->connect(transport, name, exec, fd);
1327 else
1328 die("Operation not supported by protocol");
1329 }
1330
1331 int transport_disconnect(struct transport *transport)
1332 {
1333 int ret = 0;
1334 if (transport->disconnect)
1335 ret = transport->disconnect(transport);
1336 free(transport);
1337 return ret;
1338 }
1339
1340 /*
1341 * Strip username (and password) from a URL and return
1342 * it in a newly allocated string.
1343 */
1344 char *transport_anonymize_url(const char *url)
1345 {
1346 char *anon_url, *scheme_prefix, *anon_part;
1347 size_t anon_len, prefix_len = 0;
1348
1349 anon_part = strchr(url, '@');
1350 if (url_is_local_not_ssh(url) || !anon_part)
1351 goto literal_copy;
1352
1353 anon_len = strlen(++anon_part);
1354 scheme_prefix = strstr(url, "://");
1355 if (!scheme_prefix) {
1356 if (!strchr(anon_part, ':'))
1357 /* cannot be "me@there:/path/name" */
1358 goto literal_copy;
1359 } else {
1360 const char *cp;
1361 /* make sure scheme is reasonable */
1362 for (cp = url; cp < scheme_prefix; cp++) {
1363 switch (*cp) {
1364 /* RFC 1738 2.1 */
1365 case '+': case '.': case '-':
1366 break; /* ok */
1367 default:
1368 if (isalnum(*cp))
1369 break;
1370 /* it isn't */
1371 goto literal_copy;
1372 }
1373 }
1374 /* @ past the first slash does not count */
1375 cp = strchr(scheme_prefix + 3, '/');
1376 if (cp && cp < anon_part)
1377 goto literal_copy;
1378 prefix_len = scheme_prefix - url + 3;
1379 }
1380 anon_url = xcalloc(1, 1 + prefix_len + anon_len);
1381 memcpy(anon_url, url, prefix_len);
1382 memcpy(anon_url + prefix_len, anon_part, anon_len);
1383 return anon_url;
1384 literal_copy:
1385 return xstrdup(url);
1386 }
1387
1388 struct alternate_refs_data {
1389 alternate_ref_fn *fn;
1390 void *data;
1391 };
1392
1393 static int refs_from_alternate_cb(struct alternate_object_database *e,
1394 void *data)
1395 {
1396 char *other;
1397 size_t len;
1398 struct remote *remote;
1399 struct transport *transport;
1400 const struct ref *extra;
1401 struct alternate_refs_data *cb = data;
1402
1403 e->name[-1] = '\0';
1404 other = xstrdup(real_path(e->base));
1405 e->name[-1] = '/';
1406 len = strlen(other);
1407
1408 while (other[len-1] == '/')
1409 other[--len] = '\0';
1410 if (len < 8 || memcmp(other + len - 8, "/objects", 8))
1411 goto out;
1412 /* Is this a git repository with refs? */
1413 memcpy(other + len - 8, "/refs", 6);
1414 if (!is_directory(other))
1415 goto out;
1416 other[len - 8] = '\0';
1417 remote = remote_get(other);
1418 transport = transport_get(remote, other);
1419 for (extra = transport_get_remote_refs(transport);
1420 extra;
1421 extra = extra->next)
1422 cb->fn(extra, cb->data);
1423 transport_disconnect(transport);
1424 out:
1425 free(other);
1426 return 0;
1427 }
1428
1429 void for_each_alternate_ref(alternate_ref_fn fn, void *data)
1430 {
1431 struct alternate_refs_data cb;
1432 cb.fn = fn;
1433 cb.data = data;
1434 foreach_alt_odb(refs_from_alternate_cb, &cb);
1435 }
The Best VCS Around