cvsserver: updated documentation
[git/raj.git] / git-fetch.sh
blob0346d4a45ca6a67bc0f6521dea799bf37cbb7cf1
1 #!/bin/sh
4 USAGE='<fetch-options> <repository> <refspec>...'
5 . git-sh-setup
6 . git-parse-remote
7 _x40='[0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f]'
8 _x40="$_x40$_x40$_x40$_x40$_x40$_x40$_x40$_x40"
10 LF='
12 IFS="$LF"
14 no_tags=
15 tags=
16 append=
17 force=
18 verbose=
19 update_head_ok=
20 exec=
21 upload_pack=
22 while case "$#" in 0) break ;; esac
24 case "$1" in
25 -a|--a|--ap|--app|--appe|--appen|--append)
26 append=t
28 --upl|--uplo|--uploa|--upload|--upload-|--upload-p|\
29 --upload-pa|--upload-pac|--upload-pack)
30 shift
31 exec="--exec=$1"
32 upload_pack="-u $1"
34 -f|--f|--fo|--for|--forc|--force)
35 force=t
37 -t|--t|--ta|--tag|--tags)
38 tags=t
40 -n|--n|--no|--no-|--no-t|--no-ta|--no-tag|--no-tags)
41 no_tags=t
43 -u|--u|--up|--upd|--upda|--updat|--update|--update-|--update-h|\
44 --update-he|--update-hea|--update-head|--update-head-|\
45 --update-head-o|--update-head-ok)
46 update_head_ok=t
48 -v|--verbose)
49 verbose=Yes
51 -k|--k|--ke|--kee|--keep)
52 keep=--keep
54 -*)
55 usage
58 break
60 esac
61 shift
62 done
64 case "$#" in
66 test -f "$GIT_DIR/branches/origin" ||
67 test -f "$GIT_DIR/remotes/origin" ||
68 die "Where do you want to fetch from today?"
69 set origin ;;
70 esac
72 remote_nick="$1"
73 remote=$(get_remote_url "$@")
74 refs=
75 rref=
76 rsync_slurped_objects=
78 if test "" = "$append"
79 then
80 : >"$GIT_DIR/FETCH_HEAD"
83 append_fetch_head () {
84 head_="$1"
85 remote_="$2"
86 remote_name_="$3"
87 remote_nick_="$4"
88 local_name_="$5"
89 case "$6" in
90 t) not_for_merge_='not-for-merge' ;;
91 '') not_for_merge_= ;;
92 esac
94 # remote-nick is the URL given on the command line (or a shorthand)
95 # remote-name is the $GIT_DIR relative refs/ path we computed
96 # for this refspec.
97 case "$remote_name_" in
98 HEAD)
99 note_= ;;
100 refs/heads/*)
101 note_="$(expr "$remote_name_" : 'refs/heads/\(.*\)')"
102 note_="branch '$note_' of " ;;
103 refs/tags/*)
104 note_="$(expr "$remote_name_" : 'refs/tags/\(.*\)')"
105 note_="tag '$note_' of " ;;
107 note_="$remote_name of " ;;
108 esac
109 remote_1_=$(expr "$remote_" : '\(.*\)\.git/*$') &&
110 remote_="$remote_1_"
111 note_="$note_$remote_"
113 # 2.6.11-tree tag would not be happy to be fed to resolve.
114 if git-cat-file commit "$head_" >/dev/null 2>&1
115 then
116 headc_=$(git-rev-parse --verify "$head_^0") || exit
117 echo "$headc_ $not_for_merge_ $note_" >>"$GIT_DIR/FETCH_HEAD"
118 [ "$verbose" ] && echo >&2 "* committish: $head_"
119 [ "$verbose" ] && echo >&2 " $note_"
120 else
121 echo "$head_ not-for-merge $note_" >>"$GIT_DIR/FETCH_HEAD"
122 [ "$verbose" ] && echo >&2 "* non-commit: $head_"
123 [ "$verbose" ] && echo >&2 " $note_"
125 if test "$local_name_" != ""
126 then
127 # We are storing the head locally. Make sure that it is
128 # a fast forward (aka "reverse push").
129 fast_forward_local "$local_name_" "$head_" "$note_"
133 fast_forward_local () {
134 mkdir -p "$(dirname "$GIT_DIR/$1")"
135 case "$1" in
136 refs/tags/*)
137 # Tags need not be pointing at commits so there
138 # is no way to guarantee "fast-forward" anyway.
139 if test -f "$GIT_DIR/$1"
140 then
141 if now_=$(cat "$GIT_DIR/$1") && test "$now_" = "$2"
142 then
143 [ "$verbose" ] && echo >&2 "* $1: same as $3"
144 else
145 echo >&2 "* $1: updating with $3"
147 else
148 echo >&2 "* $1: storing $3"
150 git-update-ref "$1" "$2"
153 refs/heads/*)
154 # $1 is the ref being updated.
155 # $2 is the new value for the ref.
156 local=$(git-rev-parse --verify "$1^0" 2>/dev/null)
157 if test "$local"
158 then
159 # Require fast-forward.
160 mb=$(git-merge-base "$local" "$2") &&
161 case "$2,$mb" in
162 $local,*)
163 echo >&2 "* $1: same as $3"
165 *,$local)
166 echo >&2 "* $1: fast forward to $3"
167 echo >&2 " from $local to $2"
168 git-update-ref "$1" "$2" "$local"
171 false
173 esac || {
174 echo >&2 "* $1: does not fast forward to $3;"
175 case ",$force,$single_force," in
176 *,t,*)
177 echo >&2 " forcing update."
178 git-update-ref "$1" "$2" "$local"
181 echo >&2 " not updating."
183 esac
185 else
186 echo >&2 "* $1: storing $3"
187 git-update-ref "$1" "$2"
190 esac
193 case "$update_head_ok" in
195 orig_head=$(git-rev-parse --verify HEAD 2>/dev/null)
197 esac
199 # If --tags (and later --heads or --all) is specified, then we are
200 # not talking about defaults stored in Pull: line of remotes or
201 # branches file, and just fetch those and refspecs explicitly given.
202 # Otherwise we do what we always did.
204 reflist=$(get_remote_refs_for_fetch "$@")
205 if test "$tags"
206 then
207 taglist=$(IFS=" " &&
208 git-ls-remote $upload_pack --tags "$remote" |
209 while read sha1 name
211 case "$name" in
212 (*^*) continue ;;
213 esac
214 if git-check-ref-format "$name"
215 then
216 echo ".${name}:${name}"
217 else
218 echo >&2 "warning: tag ${name} ignored"
220 done)
221 if test "$#" -gt 1
222 then
223 # remote URL plus explicit refspecs; we need to merge them.
224 reflist="$reflist$LF$taglist"
225 else
226 # No explicit refspecs; fetch tags only.
227 reflist=$taglist
231 fetch_main () {
232 reflist="$1"
233 refs=
235 for ref in $reflist
237 refs="$refs$LF$ref"
239 # These are relative path from $GIT_DIR, typically starting at refs/
240 # but may be HEAD
241 if expr "$ref" : '\.' >/dev/null
242 then
243 not_for_merge=t
244 ref=$(expr "$ref" : '\.\(.*\)')
245 else
246 not_for_merge=
248 if expr "$ref" : '\+' >/dev/null
249 then
250 single_force=t
251 ref=$(expr "$ref" : '\+\(.*\)')
252 else
253 single_force=
255 remote_name=$(expr "$ref" : '\([^:]*\):')
256 local_name=$(expr "$ref" : '[^:]*:\(.*\)')
258 rref="$rref$LF$remote_name"
260 # There are transports that can fetch only one head at a time...
261 case "$remote" in
262 http://* | https://*)
263 if [ -n "$GIT_SSL_NO_VERIFY" ]; then
264 curl_extra_args="-k"
266 remote_name_quoted=$(perl -e '
267 my $u = $ARGV[0];
268 $u =~ s{([^-a-zA-Z0-9/.])}{sprintf"%%%02x",ord($1)}eg;
269 print "$u";
270 ' "$remote_name")
271 head=$(curl -nsfL $curl_extra_args "$remote/$remote_name_quoted") &&
272 expr "$head" : "$_x40\$" >/dev/null ||
273 die "Failed to fetch $remote_name from $remote"
274 echo >&2 Fetching "$remote_name from $remote" using http
275 git-http-fetch -v -a "$head" "$remote/" || exit
277 rsync://*)
278 TMP_HEAD="$GIT_DIR/TMP_HEAD"
279 rsync -L -q "$remote/$remote_name" "$TMP_HEAD" || exit 1
280 head=$(git-rev-parse --verify TMP_HEAD)
281 rm -f "$TMP_HEAD"
282 test "$rsync_slurped_objects" || {
283 rsync -av --ignore-existing --exclude info \
284 "$remote/objects/" "$GIT_OBJECT_DIRECTORY/" || exit
286 # Look at objects/info/alternates for rsync -- http will
287 # support it natively and git native ones will do it on
288 # the remote end. Not having that file is not a crime.
289 rsync -q "$remote/objects/info/alternates" \
290 "$GIT_DIR/TMP_ALT" 2>/dev/null ||
291 rm -f "$GIT_DIR/TMP_ALT"
292 if test -f "$GIT_DIR/TMP_ALT"
293 then
294 resolve_alternates "$remote" <"$GIT_DIR/TMP_ALT" |
295 while read alt
297 case "$alt" in 'bad alternate: '*) die "$alt";; esac
298 echo >&2 "Getting alternate: $alt"
299 rsync -av --ignore-existing --exclude info \
300 "$alt" "$GIT_OBJECT_DIRECTORY/" || exit
301 done
302 rm -f "$GIT_DIR/TMP_ALT"
304 rsync_slurped_objects=t
308 # We will do git native transport with just one call later.
309 continue ;;
310 esac
312 append_fetch_head "$head" "$remote" \
313 "$remote_name" "$remote_nick" "$local_name" "$not_for_merge"
315 done
317 case "$remote" in
318 http://* | https://* | rsync://* )
319 ;; # we are already done.
321 ( : subshell because we muck with IFS
322 IFS=" $LF"
324 git-fetch-pack $exec $keep --thin "$remote" $rref || echo failed "$remote"
326 while read sha1 remote_name
328 case "$sha1" in
329 failed)
330 echo >&2 "Fetch failure: $remote"
331 exit 1 ;;
332 esac
333 found=
334 single_force=
335 for ref in $refs
337 case "$ref" in
338 +$remote_name:*)
339 single_force=t
340 not_for_merge=
341 found="$ref"
342 break ;;
343 .+$remote_name:*)
344 single_force=t
345 not_for_merge=t
346 found="$ref"
347 break ;;
348 .$remote_name:*)
349 not_for_merge=t
350 found="$ref"
351 break ;;
352 $remote_name:*)
353 not_for_merge=
354 found="$ref"
355 break ;;
356 esac
357 done
358 local_name=$(expr "$found" : '[^:]*:\(.*\)')
359 append_fetch_head "$sha1" "$remote" \
360 "$remote_name" "$remote_nick" "$local_name" "$not_for_merge"
361 done
362 ) || exit ;;
363 esac
367 fetch_main "$reflist"
369 # automated tag following
370 case "$no_tags$tags" in
372 case "$reflist" in
373 *:refs/*)
374 # effective only when we are following remote branch
375 # using local tracking branch.
376 taglist=$(IFS=" " &&
377 git-ls-remote $upload_pack --tags "$remote" |
378 sed -ne 's|^\([0-9a-f]*\)[ ]\(refs/tags/.*\)^{}$|\1 \2|p' |
379 while read sha1 name
381 test -f "$GIT_DIR/$name" && continue
382 git-check-ref-format "$name" || {
383 echo >&2 "warning: tag ${name} ignored"
384 continue
386 git-cat-file -t "$sha1" >/dev/null 2>&1 || continue
387 echo >&2 "Auto-following $name"
388 echo ".${name}:${name}"
389 done)
390 esac
391 case "$taglist" in
392 '') ;;
394 fetch_main "$taglist" ;;
395 esac
396 esac
398 # If the original head was empty (i.e. no "master" yet), or
399 # if we were told not to worry, we do not have to check.
400 case ",$update_head_ok,$orig_head," in
401 *,, | t,* )
404 curr_head=$(git-rev-parse --verify HEAD 2>/dev/null)
405 if test "$curr_head" != "$orig_head"
406 then
407 git-update-ref HEAD "$orig_head"
408 die "Cannot fetch into the current branch."
411 esac