4 use Fcntl qw/:DEFAULT :seek/;
5 use constant rev_map_fmt => 'NH40';
6 use vars qw/$_no_metadata
7 $_repack $_repack_flags $_use_svm_props $_head
8 $_use_svnsync_props $no_reuse_existing
9 $_use_log_author $_add_author_from $_localtime/;
11 use File::Path qw/mkpath/;
12 use File::Copy qw/copy/;
15 use Memoize; # core since 5.8.0, Jul 2002
16 use Memoize::Storable;
17 use POSIX qw(:signal_h);
26 use Git::SVN::Utils qw(
37 $can_use_yaml = eval { require Git::SVN::Memoize::YAML; 1};
40 our $_follow_parent = 1;
41 our $_minimize_url = 'unset';
42 our $default_repo_id = 'svn';
43 our $default_ref_id = $ENV{GIT_SVN_ID} || 'git-svn';
45 my ($_gc_nr, $_gc_period);
47 # properties that we do not log:
50 %SKIP_PROP = map { $_ => 1 } qw/svn:wc:ra_dav:version-url
51 svn:special svn:executable
52 svn:entry:committed-rev
55 svn:entry:committed-date/;
57 # some options are read globally, but can be overridden locally
58 # per [svn-remote "..."] section. Command-line options will *NOT*
59 # override options set in an [svn-remote "..."] section
61 for my $option (qw/follow_parent no_metadata use_svm_props
65 my $prop = "-$option";
68 return $self->{$prop} if exists $self->{$prop};
69 my $k = "svn-remote.$self->{repo_id}.$key";
70 eval { command_oneline(qw/config --get/, $k) };
72 $self->{$prop} = ${"Git::SVN::_$option"};
74 my $v = command_oneline(qw/config --bool/,$k);
75 $self->{$prop} = $v eq 'false' ? 0 : 1;
77 return $self->{$prop};
83 my (%LOCKFILES, %INDEX_FILES);
85 unlink keys %LOCKFILES if %LOCKFILES;
86 unlink keys %INDEX_FILES if %INDEX_FILES;
89 sub resolve_local_globs {
90 my ($url, $fetch, $glob_spec) = @_;
91 return unless defined $glob_spec;
92 my $ref = $glob_spec->{ref};
93 my $path = $glob_spec->{path};
94 foreach (command(qw#for-each-ref --format=%(refname) refs/#)) {
95 next unless m#^$ref->{regex}$#;
97 my $pathname = desanitize_refname($path->full_path($p));
98 my $refname = desanitize_refname($ref->full_path($p));
99 if (my $existing = $fetch->{$pathname}) {
100 if ($existing ne $refname) {
101 die "Refspec conflict:\n",
102 "existing: $existing\n",
103 " globbed: $refname\n";
105 my $u = (::cmt_metadata("$refname"))[0];
106 $u =~ s!^\Q$url\E(/|$)!! or die
107 "$refname: '$url' not found in '$u'\n";
108 if ($pathname ne $u) {
109 warn "W: Refspec glob conflict ",
110 "(ref: $refname):\n",
111 "expected path: $pathname\n",
113 "Continuing ahead with $u\n";
117 $fetch->{$pathname} = $refname;
122 sub parse_revision_argument {
123 my ($base, $head) = @_;
124 if (!defined $::_revision || $::_revision eq 'BASE:HEAD') {
125 return ($base, $head);
127 return ($1, $2) if ($::_revision =~ /^(\d+):(\d+)$/);
128 return ($::_revision, $::_revision) if ($::_revision =~ /^\d+$/);
129 return ($head, $head) if ($::_revision eq 'HEAD');
130 return ($base, $1) if ($::_revision =~ /^BASE:(\d+)$/);
131 return ($1, $head) if ($::_revision =~ /^(\d+):HEAD$/);
132 die "revision argument: $::_revision not understood by git-svn\n";
136 my ($repo_id, $remotes) = @_;
140 $repo_id = $gs->{repo_id};
142 $remotes ||= read_all_remotes();
143 my $remote = $remotes->{$repo_id} or
144 die "[svn-remote \"$repo_id\"] unknown\n";
145 my $fetch = $remote->{fetch};
146 my $url = $remote->{url} or die "svn-remote.$repo_id.url not defined\n";
148 my $ra = Git::SVN::Ra->new($url);
149 my $uuid = $ra->get_uuid;
150 my $head = $ra->get_latest_revnum;
152 # ignore errors, $head revision may not even exist anymore
153 eval { $ra->get_log("", $head, 0, 1, 0, 1, sub { $head = $_[1] }) };
154 warn "W: $@\n" if $@;
156 my $base = defined $fetch ? $head : 0;
158 # read the max revs for wildcard expansion (branches/*, tags/*)
159 foreach my $t (qw/branches tags/) {
160 defined $remote->{$t} or next;
161 push @globs, @{$remote->{$t}};
163 my $max_rev = eval { tmp_config(qw/--int --get/,
164 "svn-remote.$repo_id.${t}-maxRev") };
165 if (defined $max_rev && ($max_rev < $base)) {
167 } elsif (!defined $max_rev) {
173 foreach my $p (sort keys %$fetch) {
174 my $gs = Git::SVN->new($fetch->{$p}, $repo_id, $p);
175 my $lr = $gs->rev_map_max;
177 $base = $lr if ($lr < $base);
183 ($base, $head) = parse_revision_argument($base, $head);
184 $ra->gs_fetch_loop_common($base, $head, \@gs, \@globs);
187 sub read_all_remotes {
189 my $use_svm_props = eval { command_oneline(qw/config --bool
191 $use_svm_props = $use_svm_props eq 'true' if $use_svm_props;
192 my $svn_refspec = qr{\s*(.*?)\s*:\s*(.+?)\s*};
193 foreach (grep { s/^svn-remote\.// } command(qw/config -l/)) {
194 if (m!^(.+)\.fetch=$svn_refspec$!) {
195 my ($remote, $local_ref, $remote_ref) = ($1, $2, $3);
196 die("svn-remote.$remote: remote ref '$remote_ref' "
197 . "must start with 'refs/'\n")
198 unless $remote_ref =~ m{^refs/};
199 $local_ref = uri_decode($local_ref);
200 $r->{$remote}->{fetch}->{$local_ref} = $remote_ref;
201 $r->{$remote}->{svm} = {} if $use_svm_props;
202 } elsif (m!^(.+)\.usesvmprops=\s*(.*)\s*$!) {
203 $r->{$1}->{svm} = {};
204 } elsif (m!^(.+)\.url=\s*(.*)\s*$!) {
205 $r->{$1}->{url} = canonicalize_url($2);
206 } elsif (m!^(.+)\.pushurl=\s*(.*)\s*$!) {
207 $r->{$1}->{pushurl} = canonicalize_url($2);
208 } elsif (m!^(.+)\.ignore-refs=\s*(.*)\s*$!) {
209 $r->{$1}->{ignore_refs_regex} = $2;
210 } elsif (m!^(.+)\.(branches|tags)=$svn_refspec$!) {
211 my ($remote, $t, $local_ref, $remote_ref) =
213 die("svn-remote.$remote: remote ref '$remote_ref' ($t) "
214 . "must start with 'refs/'\n")
215 unless $remote_ref =~ m{^refs/};
216 $local_ref = uri_decode($local_ref);
218 require Git::SVN::GlobSpec;
222 path => Git::SVN::GlobSpec->new($local_ref, 1),
223 ref => Git::SVN::GlobSpec->new($remote_ref, 0) };
224 if (length($rs->{ref}->{right}) != 0) {
225 die "The '*' glob character must be the last ",
226 "character of '$remote_ref'\n";
228 push @{ $r->{$remote}->{$t} }, $rs;
233 if (defined $r->{$_}->{svm}) {
236 my $section = "svn-remote.$_";
238 source => tmp_config('--get',
239 "$section.svm-source"),
240 replace => tmp_config('--get',
241 "$section.svm-replace"),
244 $r->{$_}->{svm} = $svm;
248 foreach my $remote (keys %$r) {
249 foreach ( grep { defined $_ }
250 map { $r->{$remote}->{$_} } qw(branches tags) ) {
251 foreach my $rs ( @$_ ) {
252 $rs->{ignore_refs_regex} =
253 $r->{$remote}->{ignore_refs_regex};
262 $_gc_nr = $_gc_period = 1000;
263 if (defined $_repack || defined $_repack_flags) {
264 warn "Repack options are obsolete; they have no effect.\n";
268 sub verify_remotes_sanity {
269 return unless -d $ENV{GIT_DIR};
271 foreach (command(qw/config -l/)) {
272 if (m!^svn-remote\.(?:.+)\.fetch=.*:refs/remotes/(\S+)\s*$!) {
274 die "Remote ref refs/remote/$1 is tracked by",
275 "\n \"$_\"\nand\n \"$seen{$1}\"\n",
276 "Please resolve this ambiguity in ",
277 "your git configuration file before ",
285 sub find_existing_remote {
286 my ($url, $remotes) = @_;
287 return undef if $no_reuse_existing;
289 foreach my $repo_id (keys %$remotes) {
290 my $u = $remotes->{$repo_id}->{url} or next;
292 $existing = $repo_id;
298 sub init_remote_config {
299 my ($self, $url, $no_write) = @_;
300 $url = canonicalize_url($url);
301 my $r = read_all_remotes();
302 my $existing = find_existing_remote($url, $r);
305 print STDERR "Using existing ",
306 "[svn-remote \"$existing\"]\n";
308 $self->{repo_id} = $existing;
309 } elsif ($_minimize_url) {
310 my $min_url = Git::SVN::Ra->new($url)->minimize_url;
311 $existing = find_existing_remote($min_url, $r);
314 print STDERR "Using existing ",
315 "[svn-remote \"$existing\"]\n";
317 $self->{repo_id} = $existing;
319 if ($min_url ne $url) {
321 print STDERR "Using higher level of URL: ",
322 "$url => $min_url\n";
324 my $old_path = $self->path;
325 $url =~ s!^\Q$min_url\E(/|$)!!;
326 $url = join_paths($url, $old_path);
333 # verify that we aren't overwriting anything:
335 command_oneline('config', '--get',
336 "svn-remote.$self->{repo_id}.url")
338 if ($orig_url && ($orig_url ne $url)) {
339 die "svn-remote.$self->{repo_id}.url already set: ",
340 "$orig_url\nwanted to set to: $url\n";
343 my ($xrepo_id, $xpath) = find_ref($self->refname);
344 if (!$no_write && defined $xpath) {
345 die "svn-remote.$xrepo_id.fetch already set to track ",
346 "$xpath:", $self->refname, "\n";
349 command_noisy('config',
350 "svn-remote.$self->{repo_id}.url", $url);
351 my $path = $self->path;
353 $path =~ s{%([0-9A-F]{2})}{chr hex($1)}ieg;
355 command_noisy('config', '--add',
356 "svn-remote.$self->{repo_id}.fetch",
357 $self->path.":".$self->refname);
362 sub find_by_url { # repos_root and, path are optional
363 my ($class, $full_url, $repos_root, $path) = @_;
365 $full_url = canonicalize_url($full_url);
367 return undef unless defined $full_url;
368 remove_username($full_url);
369 remove_username($repos_root) if defined $repos_root;
370 my $remotes = read_all_remotes();
371 if (defined $full_url && defined $repos_root && !defined $path) {
373 $path =~ s#^\Q$repos_root\E(?:/|$)##;
375 foreach my $repo_id (keys %$remotes) {
376 my $u = $remotes->{$repo_id}->{url} or next;
378 next if defined $repos_root && $repos_root ne $u;
380 my $fetch = $remotes->{$repo_id}->{fetch} || {};
381 foreach my $t (qw/branches tags/) {
382 foreach my $globspec (@{$remotes->{$repo_id}->{$t}}) {
383 resolve_local_globs($u, $fetch, $globspec);
387 my $rwr = rewrite_root({repo_id => $repo_id});
388 my $svm = $remotes->{$repo_id}->{svm}
389 if defined $remotes->{$repo_id}->{svm};
390 unless (defined $p) {
397 } elsif (defined $svm) {
399 $prefix = $svm->{replace};
400 $prefix =~ s#^\Q$u\E(?:/|$)##;
403 $p =~ s#^\Q$z\E(?:/|$)#$prefix# or next;
406 # remote fetch paths are not URI escaped. Decode ours
410 foreach my $f (keys %$fetch) {
412 return Git::SVN->new($fetch->{$f}, $repo_id, $f);
419 my ($class, $url, $path, $repo_id, $ref_id, $no_write) = @_;
420 my $self = _new($class, $repo_id, $ref_id, $path);
422 $self->init_remote_config($url, $no_write);
429 foreach (command(qw/config -l/)) {
430 next unless m!^svn-remote\.(.+)\.fetch=
431 \s*(.*?)\s*:\s*(.+?)\s*$!x;
432 my ($repo_id, $path, $ref) = ($1, $2, $3);
433 if ($ref eq $ref_id) {
434 $path = '' if ($path =~ m#^\./?#);
435 return ($repo_id, $path);
438 (undef, undef, undef);
442 my ($class, $ref_id, $repo_id, $path) = @_;
443 if (defined $ref_id && !defined $repo_id && !defined $path) {
444 ($repo_id, $path) = find_ref($ref_id);
445 if (!defined $repo_id) {
446 die "Could not find a \"svn-remote.*.fetch\" key ",
447 "in the repository configuration matching: ",
451 my $self = _new($class, $repo_id, $ref_id, $path);
452 if (!defined $self->path || !length $self->path) {
453 my $fetch = command_oneline('config', '--get',
454 "svn-remote.$repo_id.fetch",
456 die "Failed to read \"svn-remote.$repo_id.fetch\" ",
457 "\":$ref_id\$\" in config\n";
458 my($path) = split(/\s*:\s*/, $fetch);
462 my $path = $self->path;
467 my $url = command_oneline('config', '--get',
468 "svn-remote.$repo_id.url") or
469 die "Failed to read \"svn-remote.$repo_id.url\" in config\n";
471 $self->{pushurl} = eval { command_oneline('config', '--get',
472 "svn-remote.$repo_id.pushurl") };
478 my ($refname) = $_[0]->{ref_id} ;
480 # It cannot end with a slash /, we'll throw up on this because
481 # SVN can't have directories with a slash in their name, either:
482 if ($refname =~ m{/$}) {
483 die "ref: '$refname' ends with a trailing slash, this is ",
484 "not permitted by git nor Subversion\n";
487 # It cannot have ASCII control character space, tilde ~, caret ^,
488 # colon :, question-mark ?, asterisk *, space, or open bracket [
491 # Additionally, % must be escaped because it is used for escaping
492 # and we want our escaped refname to be reversible
493 $refname =~ s{([ \%~\^:\?\*\[\t])}{uc sprintf('%%%02x',ord($1))}eg;
495 # no slash-separated component can begin with a dot .
497 $refname =~ s{/\.}{/%2E}g;
499 # It cannot have two consecutive dots .. anywhere
501 $refname =~ s{\.\.}{%2E%2E}g;
503 # trailing dots and .lock are not allowed
504 # .$ becomes %2E and .lock becomes %2Elock
505 $refname =~ s{\.(?=$|lock$)}{%2E};
507 # the sequence @{ is used to access the reflog
509 $refname =~ s{\@\{}{%40\{}g;
514 sub desanitize_refname {
516 $refname =~ s{%(?:([0-9A-F]{2}))}{chr hex($1)}eg;
522 return $self->{svm}->{uuid} if $self->svm;
524 unless ($self->{svm}) {
525 die "SVM UUID not cached, and reading remotely failed\n";
527 $self->{svm}->{uuid};
532 return $self->{svm} if $self->{svm};
534 # see if we have it in our config, first:
536 my $section = "svn-remote.$self->{repo_id}";
538 source => tmp_config('--get', "$section.svm-source"),
539 uuid => tmp_config('--get', "$section.svm-uuid"),
540 replace => tmp_config('--get', "$section.svm-replace"),
543 if ($svm && $svm->{source} && $svm->{uuid} && $svm->{replace}) {
550 my ($self, $ra) = @_;
551 return $ra if $self->svm;
553 my @err = ( "useSvmProps set, but failed to read SVM properties\n",
554 "(svm:source, svm:uuid) ",
555 "from the following URLs:\n" );
557 my ($self, $ra, $path, $r) = @_;
558 my $props = ($ra->get_dir($path, $r))[2];
559 my $src = $props->{'svm:source'};
560 my $uuid = $props->{'svm:uuid'};
561 return undef if (!$src || !$uuid);
565 $uuid =~ m{^[0-9a-f\-]{30,}$}i
566 or die "doesn't look right - svm:uuid is '$uuid'\n";
568 # the '!' is used to mark the repos_root!/relative/path
570 $src =~ s{/+$}{}; # no trailing slashes please
571 # username is of no interest
572 $src =~ s{(^[a-z\+]*://)[^/@]*@}{$1};
574 my $replace = add_path_to_url($ra->url, $path);
576 my $section = "svn-remote.$self->{repo_id}";
577 tmp_config("$section.svm-source", $src);
578 tmp_config("$section.svm-replace", $replace);
579 tmp_config("$section.svm-uuid", $uuid);
587 my $r = $ra->get_latest_revnum;
588 my $path = $self->path;
590 while (length $path) {
591 my $try = add_path_to_url($self->url, $path);
592 unless ($tried{$try}) {
593 return $ra if $self->read_svm_props($ra, $path, $r);
596 $path =~ s#/?[^/]+$##;
598 die "Path: '$path' should be ''\n" if $path ne '';
599 return $ra if $self->read_svm_props($ra, $path, $r);
600 $tried{ add_path_to_url($self->url, $path) } = 1;
602 if ($ra->{repos_root} eq $self->url) {
603 die @err, (map { " $_\n" } keys %tried), "\n";
606 # nope, make sure we're connected to the repository root:
609 $path = $ra->{svn_path};
610 $ra = Git::SVN::Ra->new($ra->{repos_root});
611 while (length $path) {
612 my $try = add_path_to_url($ra->url, $path);
613 unless ($tried{$try}) {
614 $ok = $self->read_svm_props($ra, $path, $r);
618 $path =~ s#/?[^/]+$##;
620 die "Path: '$path' should be ''\n" if $path ne '';
621 $ok ||= $self->read_svm_props($ra, $path, $r);
622 $tried{ add_path_to_url($ra->url, $path) } = 1;
624 die @err, (map { " $_\n" } keys %tried), "\n";
626 Git::SVN::Ra->new($self->url);
631 return $self->{svnsync} if $self->{svnsync};
633 if ($self->no_metadata) {
634 die "Can't have both 'noMetadata' and ",
635 "'useSvnsyncProps' options set!\n";
637 if ($self->rewrite_root) {
638 die "Can't have both 'useSvnsyncProps' and 'rewriteRoot' ",
641 if ($self->rewrite_uuid) {
642 die "Can't have both 'useSvnsyncProps' and 'rewriteUUID' ",
647 # see if we have it in our config, first:
649 my $section = "svn-remote.$self->{repo_id}";
651 my $url = tmp_config('--get', "$section.svnsync-url");
652 ($url) = ($url =~ m{^([a-z\+]+://\S+)$}) or
653 die "doesn't look right - svn:sync-from-url is '$url'\n";
655 my $uuid = tmp_config('--get', "$section.svnsync-uuid");
656 ($uuid) = ($uuid =~ m{^([0-9a-f\-]{30,})$}i) or
657 die "doesn't look right - svn:sync-from-uuid is '$uuid'\n";
659 $svnsync = { url => $url, uuid => $uuid }
661 if ($svnsync && $svnsync->{url} && $svnsync->{uuid}) {
662 return $self->{svnsync} = $svnsync;
665 my $err = "useSvnsyncProps set, but failed to read " .
666 "svnsync property: svn:sync-from-";
667 my $rp = $self->ra->rev_proplist(0);
669 my $url = $rp->{'svn:sync-from-url'} or die $err . "url\n";
670 ($url) = ($url =~ m{^([a-z\+]+://\S+)$}) or
671 die "doesn't look right - svn:sync-from-url is '$url'\n";
673 my $uuid = $rp->{'svn:sync-from-uuid'} or die $err . "uuid\n";
674 ($uuid) = ($uuid =~ m{^([0-9a-f\-]{30,})$}i) or
675 die "doesn't look right - svn:sync-from-uuid is '$uuid'\n";
677 my $section = "svn-remote.$self->{repo_id}";
678 tmp_config('--add', "$section.svnsync-uuid", $uuid);
679 tmp_config('--add', "$section.svnsync-url", $url);
680 return $self->{svnsync} = { url => $url, uuid => $uuid };
683 # this allows us to memoize our SVN::Ra UUID locally and avoid a
684 # remote lookup (useful for 'git svn log').
687 unless ($self->{ra_uuid}) {
688 my $key = "svn-remote.$self->{repo_id}.uuid";
689 my $uuid = eval { tmp_config('--get', $key) };
690 if (!$@ && $uuid && $uuid =~ /^([a-f\d\-]{30,})$/i) {
691 $self->{ra_uuid} = $uuid;
693 die "ra_uuid called without URL\n" unless $self->url;
694 $self->{ra_uuid} = $self->ra->get_uuid;
695 tmp_config('--add', $key, $self->{ra_uuid});
701 sub _set_repos_root {
702 my ($self, $repos_root) = @_;
703 my $k = "svn-remote.$self->{repo_id}.reposRoot";
704 $repos_root ||= $self->ra->{repos_root};
705 tmp_config($k, $repos_root);
711 my $k = "svn-remote.$self->{repo_id}.reposRoot";
712 eval { tmp_config('--get', $k) } || $self->_set_repos_root;
717 my $ra = Git::SVN::Ra->new($self->url);
718 $self->_set_repos_root($ra->{repos_root});
719 if ($self->use_svm_props && !$self->{svm}) {
720 if ($self->no_metadata) {
721 die "Can't have both 'noMetadata' and ",
722 "'useSvmProps' options set!\n";
723 } elsif ($self->use_svnsync_props) {
724 die "Can't have both 'useSvnsyncProps' and ",
725 "'useSvmProps' options set!\n";
727 $ra = $self->_set_svm_vars($ra);
728 $self->{-want_revprops} = 1;
733 # prop_walk(PATH, REV, SUB)
734 # -------------------------
735 # Recursively traverse PATH at revision REV and invoke SUB for each
736 # directory that contains a SVN property. SUB will be invoked as
737 # follows: &SUB(gs, path, props); where `gs' is this instance of
738 # Git::SVN, `path' the path to the directory where the properties
739 # `props' were found. The `path' will be relative to point of checkout,
740 # that is, if url://repo/trunk is the current Git branch, and that
741 # directory contains a sub-directory `d', SUB will be invoked with `/d/'
742 # as `path' (note the trailing `/').
744 my ($self, $path, $rev, $sub) = @_;
747 my ($dirent, undef, $props) = $self->ra->get_dir($path, $rev);
750 # Strip the irrelevant part of the path.
751 $p =~ s#^/+\Q@{[$self->path]}\E(/|$)#/#;
752 # Ensure the path is terminated by a `/'.
755 # The properties contain all the internal SVN stuff nobody
756 # (usually) cares about.
757 my $interesting_props = 0;
758 foreach (keys %{$props}) {
759 # If it doesn't start with `svn:', it must be a
760 # user-defined property.
761 ++$interesting_props and next if $_ !~ /^svn:/;
762 # FIXME: Fragile, if SVN adds new public properties,
763 # this needs to be updated.
764 ++$interesting_props if /^svn:(?:ignore|keywords|executable
766 |externals|needs-lock)$/x;
768 &$sub($self, $p, $props) if $interesting_props;
770 foreach (sort keys %$dirent) {
771 next if $dirent->{$_}->{kind} != $SVN::Node::dir;
772 $self->prop_walk($self->path . $p . $_, $rev, $sub);
776 sub last_rev { ($_[0]->last_rev_commit)[0] }
777 sub last_commit { ($_[0]->last_rev_commit)[1] }
779 # returns the newest SVN revision number and newest commit SHA1
780 sub last_rev_commit {
782 if (defined $self->{last_rev} && defined $self->{last_commit}) {
783 return ($self->{last_rev}, $self->{last_commit});
785 my $c = ::verify_ref($self->refname.'^0');
786 if ($c && !$self->use_svm_props && !$self->no_metadata) {
787 my $rev = (::cmt_metadata($c))[1];
789 ($self->{last_rev}, $self->{last_commit}) = ($rev, $c);
793 my $map_path = $self->map_path;
794 unless (-e $map_path) {
795 ($self->{last_rev}, $self->{last_commit}) = (undef, undef);
796 return (undef, undef);
798 my ($rev, $commit) = $self->rev_map_max(1);
799 ($self->{last_rev}, $self->{last_commit}) = ($rev, $commit);
800 return ($rev, $commit);
803 sub get_fetch_range {
804 my ($self, $min, $max) = @_;
805 $max ||= $self->ra->get_latest_revnum;
806 $min ||= $self->rev_map_max;
812 my $old_def_config = "$ENV{GIT_DIR}/svn/config";
813 my $config = "$ENV{GIT_DIR}/svn/.metadata";
814 if (! -f $config && -f $old_def_config) {
815 rename $old_def_config, $config or
816 die "Failed rename $old_def_config => $config: $!\n";
818 my $old_config = $ENV{GIT_CONFIG};
819 $ENV{GIT_CONFIG} = $config;
822 unless (-f $config) {
824 open my $fh, '>', $config or
825 die "Can't open $config: $!\n";
826 print $fh "; This file is used internally by ",
828 "Couldn't write to $config: $!\n";
829 print $fh "; You should not have to edit it\n" or
830 die "Couldn't write to $config: $!\n";
831 close $fh or die "Couldn't close $config: $!\n";
833 command('config', @args);
836 if (defined $old_config) {
837 $ENV{GIT_CONFIG} = $old_config;
839 delete $ENV{GIT_CONFIG};
842 wantarray ? @ret : $ret[0];
846 my ($self, $sub) = @_;
847 my $old_index = $ENV{GIT_INDEX_FILE};
848 $ENV{GIT_INDEX_FILE} = $self->{index};
851 my ($dir, $base) = ($self->{index} =~ m#^(.*?)/?([^/]+)$#);
852 mkpath([$dir]) unless -d $dir;
856 if (defined $old_index) {
857 $ENV{GIT_INDEX_FILE} = $old_index;
859 delete $ENV{GIT_INDEX_FILE};
862 wantarray ? @ret : $ret[0];
865 sub assert_index_clean {
866 my ($self, $treeish) = @_;
868 $self->tmp_index_do(sub {
869 command_noisy('read-tree', $treeish) unless -e $self->{index};
870 my $x = command_oneline('write-tree');
871 my ($y) = (command(qw/cat-file commit/, $treeish) =~
872 /^tree ($::sha1)/mo);
875 warn "Index mismatch: $y != $x\nrereading $treeish\n";
876 unlink $self->{index} or die "unlink $self->{index}: $!\n";
877 command_noisy('read-tree', $treeish);
878 $x = command_oneline('write-tree');
880 fatal "trees ($treeish) $y != $x\n",
881 "Something is seriously wrong...";
886 sub get_commit_parents {
887 my ($self, $log_entry) = @_;
888 my (%seen, @ret, @tmp);
889 # legacy support for 'set-tree'; this is only used by set_tree_cb:
890 if (my $ip = $self->{inject_parents}) {
891 if (my $commit = delete $ip->{$log_entry->{revision}}) {
895 if (my $cur = ::verify_ref($self->refname.'^0')) {
898 if (my $ipd = $self->{inject_parents_dcommit}) {
899 if (my $commit = delete $ipd->{$log_entry->{revision}}) {
903 push @tmp, $_ foreach (@{$log_entry->{parents}}, @tmp);
904 while (my $p = shift @tmp) {
914 return $self->{-rewrite_root} if exists $self->{-rewrite_root};
915 my $k = "svn-remote.$self->{repo_id}.rewriteRoot";
916 my $rwr = eval { command_oneline(qw/config --get/, $k) };
919 if ($rwr !~ m#^[a-z\+]+://#) {
920 die "$rwr is not a valid URL (key: $k)\n";
923 $self->{-rewrite_root} = $rwr;
928 return $self->{-rewrite_uuid} if exists $self->{-rewrite_uuid};
929 my $k = "svn-remote.$self->{repo_id}.rewriteUUID";
930 my $rwid = eval { command_oneline(qw/config --get/, $k) };
933 if ($rwid !~ m#^[a-f0-9]{8}-(?:[a-f0-9]{4}-){3}[a-f0-9]{12}$#) {
934 die "$rwid is not a valid UUID (key: $k)\n";
937 $self->{-rewrite_uuid} = $rwid;
942 my $url = $self->rewrite_root || $self->url;
943 return canonicalize_url( add_path_to_url( $url, $self->path ) );
948 return canonicalize_url( add_path_to_url( $self->url, $self->path ) );
953 if ($self->{pushurl}) {
954 return canonicalize_url( add_path_to_url( $self->{pushurl}, $self->path ) );
956 return $self->full_url;
960 sub set_commit_header_env {
961 my ($log_entry) = @_;
963 foreach my $ned (qw/NAME EMAIL DATE/) {
964 foreach my $ac (qw/AUTHOR COMMITTER/) {
965 $env{"GIT_${ac}_${ned}"} = $ENV{"GIT_${ac}_${ned}"};
969 $ENV{GIT_AUTHOR_NAME} = $log_entry->{name};
970 $ENV{GIT_AUTHOR_EMAIL} = $log_entry->{email};
971 $ENV{GIT_AUTHOR_DATE} = $ENV{GIT_COMMITTER_DATE} = $log_entry->{date};
973 $ENV{GIT_COMMITTER_NAME} = (defined $log_entry->{commit_name})
974 ? $log_entry->{commit_name}
975 : $log_entry->{name};
976 $ENV{GIT_COMMITTER_EMAIL} = (defined $log_entry->{commit_email})
977 ? $log_entry->{commit_email}
978 : $log_entry->{email};
982 sub restore_commit_header_env {
984 foreach my $ned (qw/NAME EMAIL DATE/) {
985 foreach my $ac (qw/AUTHOR COMMITTER/) {
986 my $k = "GIT_${ac}_${ned}";
987 if (defined $env->{$k}) {
988 $ENV{$k} = $env->{$k};
997 command_noisy('gc', '--auto');
1001 my ($self, $log_entry) = @_;
1002 my $lr = $self->last_rev;
1003 if (defined $lr && $lr >= $log_entry->{revision}) {
1004 die "Last fetched revision of ", $self->refname,
1005 " was r$lr, but we are about to fetch: ",
1006 "r$log_entry->{revision}!\n";
1008 if (my $c = $self->rev_map_get($log_entry->{revision})) {
1009 croak "$log_entry->{revision} = $c already exists! ",
1010 "Why are we refetching it?\n";
1012 my $old_env = set_commit_header_env($log_entry);
1013 my $tree = $log_entry->{tree};
1014 if (!defined $tree) {
1015 $tree = $self->tmp_index_do(sub {
1016 command_oneline('write-tree') });
1018 die "Tree is not a valid sha1: $tree\n" if $tree !~ /^$::sha1$/o;
1020 my @exec = ('git', 'commit-tree', $tree);
1021 foreach ($self->get_commit_parents($log_entry)) {
1022 push @exec, '-p', $_;
1024 defined(my $pid = open3(my $msg_fh, my $out_fh, '>&STDERR', @exec))
1028 # we always get UTF-8 from SVN, but we may want our commits in
1029 # a different encoding.
1030 if (my $enc = Git::config('i18n.commitencoding')) {
1032 Encode::from_to($log_entry->{log}, 'UTF-8', $enc);
1034 print $msg_fh $log_entry->{log} or croak $!;
1035 restore_commit_header_env($old_env);
1036 unless ($self->no_metadata) {
1037 print $msg_fh "\ngit-svn-id: $log_entry->{metadata}\n"
1040 $msg_fh->flush == 0 or croak $!;
1041 close $msg_fh or croak $!;
1042 chomp(my $commit = do { local $/; <$out_fh> });
1043 close $out_fh or croak $!;
1046 if ($commit !~ /^$::sha1$/o) {
1047 die "Failed to commit, invalid sha1: $commit\n";
1050 $self->rev_map_set($log_entry->{revision}, $commit, 1);
1052 $self->{last_rev} = $log_entry->{revision};
1053 $self->{last_commit} = $commit;
1054 print "r$log_entry->{revision}" unless $::_q > 1;
1055 if (defined $log_entry->{svm_revision}) {
1056 print " (\@$log_entry->{svm_revision})" unless $::_q > 1;
1057 $self->rev_map_set($log_entry->{svm_revision}, $commit,
1058 0, $self->svm_uuid);
1060 print " = $commit ($self->{ref_id})\n" unless $::_q > 1;
1061 if (--$_gc_nr == 0) {
1062 $_gc_nr = $_gc_period;
1069 my ($self, $paths, $r) = @_;
1070 return 1 if $self->path eq '';
1071 if (my $path = $paths->{"/".$self->path}) {
1072 return ($path->{action} eq 'D') ? 0 : 1;
1074 $self->{path_regex} ||= qr{^/\Q@{[$self->path]}\E/};
1075 if (grep /$self->{path_regex}/, keys %$paths) {
1079 foreach (split m#/#, $self->path) {
1081 next unless ($paths->{$c} &&
1082 ($paths->{$c}->{action} =~ /^[AR]$/));
1083 if ($self->ra->check_path($self->path, $r) ==
1091 sub find_parent_branch {
1092 my ($self, $paths, $rev) = @_;
1093 return undef unless $self->follow_parent;
1094 unless (defined $paths) {
1095 my $err_handler = $SVN::Error::handler;
1096 $SVN::Error::handler = \&Git::SVN::Ra::skip_unknown_revs;
1097 $self->ra->get_log([$self->path], $rev, $rev, 0, 1, 1,
1098 sub { $paths = $_[0] });
1099 $SVN::Error::handler = $err_handler;
1101 return undef unless defined $paths;
1103 # look for a parent from another branch:
1104 my @b_path_components = split m#/#, $self->path;
1105 my @a_path_components;
1107 while (@b_path_components) {
1108 $i = $paths->{'/'.join('/', @b_path_components)};
1109 last if $i && defined $i->{copyfrom_path};
1110 unshift(@a_path_components, pop(@b_path_components));
1112 return undef unless defined $i && defined $i->{copyfrom_path};
1113 my $branch_from = $i->{copyfrom_path};
1114 if (@a_path_components) {
1115 print STDERR "branch_from: $branch_from => ";
1116 $branch_from .= '/'.join('/', @a_path_components);
1117 print STDERR $branch_from, "\n";
1119 my $r = $i->{copyfrom_rev};
1120 my $repos_root = $self->ra->{repos_root};
1121 my $url = $self->ra->url;
1122 my $new_url = canonicalize_url( add_path_to_url( $url, $branch_from ) );
1123 print STDERR "Found possible branch point: ",
1124 "$new_url => ", $self->full_url, ", $r\n"
1126 $branch_from =~ s#^/##;
1127 my $gs = $self->other_gs($new_url, $url,
1128 $branch_from, $r, $self->{ref_id});
1129 my ($r0, $parent) = $gs->find_rev_before($r, 1);
1132 if (!defined $r0 || !defined $parent) {
1133 ($base, $head) = parse_revision_argument(0, $r);
1136 $gs->ra->get_log([$gs->path], $r0 + 1, $r, 1,
1137 0, 1, sub { $base = $_[1] - 1 });
1140 if (defined $base && $base <= $r) {
1141 $gs->fetch($base, $r);
1143 ($r0, $parent) = $gs->find_rev_before($r, 1);
1145 if (defined $r0 && defined $parent) {
1146 print STDERR "Found branch parent: ($self->{ref_id}) $parent\n"
1149 if ($self->ra->can_do_switch) {
1150 $self->assert_index_clean($parent);
1151 print STDERR "Following parent with do_switch\n"
1153 # do_switch works with svn/trunk >= r22312, but that
1154 # is not included with SVN 1.4.3 (the latest version
1155 # at the moment), so we can't rely on it
1156 $self->{last_rev} = $r0;
1157 $self->{last_commit} = $parent;
1158 $ed = Git::SVN::Fetcher->new($self, $gs->path);
1159 $gs->ra->gs_do_switch($r0, $rev, $gs,
1160 $self->full_url, $ed)
1161 or die "SVN connection failed somewhere...\n";
1162 } elsif ($self->ra->trees_match($new_url, $r0,
1163 $self->full_url, $rev)) {
1164 print STDERR "Trees match:\n",
1166 " ${\$self->full_url}\@$rev\n",
1167 "Following parent with no changes\n"
1169 $self->tmp_index_do(sub {
1170 command_noisy('read-tree', $parent);
1172 $self->{last_commit} = $parent;
1174 print STDERR "Following parent with do_update\n"
1176 $ed = Git::SVN::Fetcher->new($self);
1177 $self->ra->gs_do_update($rev, $rev, $self, $ed)
1178 or die "SVN connection failed somewhere...\n";
1180 print STDERR "Successfully followed parent\n" unless $::_q > 1;
1181 return $self->make_log_entry($rev, [$parent], $ed);
1187 my ($self, $paths, $rev) = @_;
1189 my ($last_rev, @parents);
1190 if (my $lc = $self->last_commit) {
1191 # we can have a branch that was deleted, then re-added
1192 # under the same name but copied from another path, in
1193 # which case we'll have multiple parents (we don't
1194 # want to break the original ref, nor lose copypath info):
1195 if (my $log_entry = $self->find_parent_branch($paths, $rev)) {
1196 push @{$log_entry->{parents}}, $lc;
1199 $ed = Git::SVN::Fetcher->new($self);
1200 $last_rev = $self->{last_rev};
1205 if (my $log_entry = $self->find_parent_branch($paths, $rev)) {
1208 $ed = Git::SVN::Fetcher->new($self);
1210 unless ($self->ra->gs_do_update($last_rev, $rev, $self, $ed)) {
1211 die "SVN connection failed somewhere...\n";
1213 $self->make_log_entry($rev, \@parents, $ed);
1217 my ($self, $r) = @_;
1220 my ($r, $empty_dirs, $line) = @_;
1221 if (defined $r && $line =~ /^r(\d+)$/) {
1222 return 0 if $1 > $r;
1223 } elsif ($line =~ /^ \+empty_dir: (.+)$/) {
1224 $empty_dirs->{$1} = 1;
1225 } elsif ($line =~ /^ \-empty_dir: (.+)$/) {
1226 my @d = grep {m[^\Q$1\E(/|$)]} (keys %$empty_dirs);
1227 delete @$empty_dirs{@d};
1232 my %empty_dirs = ();
1233 my $gz_file = "$self->{dir}/unhandled.log.gz";
1235 if (!can_compress()) {
1236 warn "Compress::Zlib could not be found; ",
1237 "empty directories in $gz_file will not be read\n";
1239 my $gz = Compress::Zlib::gzopen($gz_file, "rb") or
1240 die "Unable to open $gz_file: $!\n";
1242 while ($gz->gzreadline($line) > 0) {
1243 scan($r, \%empty_dirs, $line) or last;
1249 if (open my $fh, '<', "$self->{dir}/unhandled.log") {
1250 binmode $fh or croak "binmode: $!";
1252 scan($r, \%empty_dirs, $_) or last;
1257 my $strip = qr/\A\Q@{[$self->path]}\E(?:\/|$)/;
1258 foreach my $d (sort keys %empty_dirs) {
1259 $d = uri_decode($d);
1261 next unless length($d);
1264 warn "$d exists but is not a directory\n";
1266 print "creating empty directory: $d\n";
1273 my ($self, $ed) = @_;
1275 my $h = $ed->{empty};
1276 foreach (sort keys %$h) {
1277 my $act = $h->{$_} ? '+empty_dir' : '-empty_dir';
1278 push @out, " $act: " . uri_encode($_);
1279 warn "W: $act: $_\n";
1281 foreach my $t (qw/dir_prop file_prop/) {
1282 $h = $ed->{$t} or next;
1283 foreach my $path (sort keys %$h) {
1284 my $ppath = $path eq '' ? '.' : $path;
1285 foreach my $prop (sort keys %{$h->{$path}}) {
1286 next if $SKIP_PROP{$prop};
1287 my $v = $h->{$path}->{$prop};
1288 my $t_ppath_prop = "$t: " .
1289 uri_encode($ppath) . ' ' .
1292 push @out, " +$t_ppath_prop " .
1295 push @out, " -$t_ppath_prop";
1300 foreach my $t (qw/absent_file absent_directory/) {
1301 $h = $ed->{$t} or next;
1302 foreach my $parent (sort keys %$h) {
1303 foreach my $path (sort @{$h->{$parent}}) {
1304 push @out, " $t: " .
1305 uri_encode("$parent/$path");
1306 warn "W: $t: $parent/$path ",
1307 "Insufficient permissions?\n";
1315 # some systmes don't handle or mishandle %z, so be creative.
1316 my $t = shift || time;
1317 my $gm = timelocal(gmtime($t));
1318 my $sign = qw( + + - )[ $t <=> $gm ];
1319 return sprintf("%s%02d%02d", $sign, (gmtime(abs($t - $gm)))[2,1]);
1322 # parse_svn_date(DATE)
1323 # --------------------
1324 # Given a date (in UTC) from Subversion, return a string in the format
1325 # "<TZ Offset> <local date/time>" that Git will use.
1327 # By default the parsed date will be in UTC; if $Git::SVN::_localtime
1328 # is true we'll convert it to the local timezone instead.
1329 sub parse_svn_date {
1330 my $date = shift || return '+0000 1970-01-01 00:00:00';
1331 my ($Y,$m,$d,$H,$M,$S) = ($date =~ /^(\d{4})\-(\d\d)\-(\d\d)T
1332 (\d\d)\:(\d\d)\:(\d\d)\.\d*Z$/x) or
1333 croak "Unable to parse date: $date\n";
1334 my $parsed_date; # Set next.
1336 if ($Git::SVN::_localtime) {
1337 # Translate the Subversion datetime to an epoch time.
1338 # Begin by switching ourselves to $date's timezone, UTC.
1339 my $old_env_TZ = $ENV{TZ};
1343 POSIX::strftime('%s', $S, $M, $H, $d, $m - 1, $Y - 1900);
1345 # Determine our local timezone (including DST) at the
1346 # time of $epoch_in_UTC. $Git::SVN::Log::TZ stored the
1347 # value of TZ, if any, at the time we were run.
1348 if (defined $Git::SVN::Log::TZ) {
1349 $ENV{TZ} = $Git::SVN::Log::TZ;
1354 my $our_TZ = get_tz();
1356 # This converts $epoch_in_UTC into our local timezone.
1357 my ($sec, $min, $hour, $mday, $mon, $year,
1358 $wday, $yday, $isdst) = localtime($epoch_in_UTC);
1360 $parsed_date = sprintf('%s %04d-%02d-%02d %02d:%02d:%02d',
1361 $our_TZ, $year + 1900, $mon + 1,
1362 $mday, $hour, $min, $sec);
1364 # Reset us to the timezone in effect when we entered
1366 if (defined $old_env_TZ) {
1367 $ENV{TZ} = $old_env_TZ;
1372 $parsed_date = "+0000 $Y-$m-$d $H:$M:$S";
1375 return $parsed_date;
1379 my ($self, $new_url, $url,
1380 $branch_from, $r, $old_ref_id) = @_;
1381 my $gs = Git::SVN->find_by_url($new_url, $url, $branch_from);
1383 my $ref_id = $old_ref_id;
1384 $ref_id =~ s/\@\d+-*$//;
1386 # just grow a tail if we're not unique enough :x
1387 $ref_id .= '-' while find_ref($ref_id);
1388 my ($u, $p, $repo_id) = ($new_url, '', $ref_id);
1389 if ($u =~ s#^\Q$url\E(/|$)##) {
1392 $repo_id = $self->{repo_id};
1395 # It is possible to tag two different subdirectories at
1396 # the same revision. If the url for an existing ref
1397 # does not match, we must either find a ref with a
1398 # matching url or create a new ref by growing a tail.
1399 $gs = Git::SVN->init($u, $p, $repo_id, $ref_id, 1);
1400 my (undef, $max_commit) = $gs->rev_map_max(1);
1401 last if (!$max_commit);
1402 my ($url) = ::cmt_metadata($max_commit);
1403 last if ($url eq $gs->metadata_url);
1406 print STDERR "Initializing parent: $ref_id\n" unless $::_q > 1;
1411 sub call_authors_prog {
1412 my ($orig_author) = @_;
1413 $orig_author = command_oneline('rev-parse', '--sq-quote', $orig_author);
1414 my $author = `$::_authors_prog $orig_author`;
1416 die "$::_authors_prog failed with exit code $?\n"
1418 if ($author =~ /^\s*(.+?)\s*<(.*)>\s*$/) {
1419 my ($name, $email) = ($1, $2);
1420 $email = undef if length $2 == 0;
1421 return [$name, $email];
1423 die "Author: $orig_author: $::_authors_prog returned "
1424 . "invalid author format: $author\n";
1430 if (!defined $author || length $author == 0) {
1431 $author = '(no author)';
1433 if (!defined $::users{$author}) {
1434 if (defined $::_authors_prog) {
1435 $::users{$author} = call_authors_prog($author);
1436 } elsif (defined $::_authors) {
1437 die "Author: $author not defined in $::_authors file\n";
1443 sub find_extra_svk_parents {
1444 my ($self, $ed, $tickets, $parents) = @_;
1445 # aha! svk:merge property changed...
1446 my @tickets = split "\n", $tickets;
1448 for my $ticket ( @tickets ) {
1449 my ($uuid, $path, $rev) = split /:/, $ticket;
1450 if ( $uuid eq $self->ra_uuid ) {
1451 my $repos_root = $self->url;
1452 my $branch_from = $path;
1453 $branch_from =~ s{^/}{};
1454 my $gs = $self->other_gs(add_path_to_url( $repos_root, $branch_from ),
1459 if ( my $commit = $gs->rev_map_get($rev, $uuid) ) {
1460 # wahey! we found it, but it might be
1462 push @known_parents, [ $rev, $commit ];
1466 # Ordering matters; highest-numbered commit merge tickets
1467 # first, as they may account for later merge ticket additions
1469 @known_parents = map {$_->[1]} sort {$b->[0] <=> $a->[0]} @known_parents;
1470 for my $parent ( @known_parents ) {
1471 my @cmd = ('rev-list', $parent, map { "^$_" } @$parents );
1472 my ($msg_fh, $ctx) = command_output_pipe(@cmd);
1474 while ( <$msg_fh> ) {
1477 command_close_pipe($msg_fh, $ctx);
1480 "Found merge parent (svk:merge ticket): $parent\n";
1481 push @$parents, $parent;
1486 sub lookup_svn_merge {
1491 my ($source, $revs) = split ":", $merge;
1494 my $gs = Git::SVN->find_by_url($url.$source, $url, $path);
1496 warn "Couldn't find revmap for $url$source\n";
1499 my @ranges = split ",", $revs;
1500 my ($tip, $tip_commit);
1501 my @merged_commit_ranges;
1503 for my $range ( @ranges ) {
1504 my ($bottom, $top) = split "-", $range;
1506 my $bottom_commit = $gs->find_rev_after( $bottom, 1, $top );
1507 my $top_commit = $gs->find_rev_before( $top, 1, $bottom );
1509 unless ($top_commit and $bottom_commit) {
1510 warn "W:unknown path/rev in svn:mergeinfo "
1511 ."dirprop: $source:$range\n";
1515 if (scalar(command('rev-parse', "$bottom_commit^@"))) {
1516 push @merged_commit_ranges,
1517 "$bottom_commit^..$top_commit";
1519 push @merged_commit_ranges, "$top_commit";
1522 if ( !defined $tip or $top > $tip ) {
1524 $tip_commit = $top_commit;
1527 return ($tip_commit, @merged_commit_ranges);
1531 my ($msg_fh, $ctx) = command_output_pipe(
1535 while ( <$msg_fh> ) {
1539 command_close_pipe($msg_fh, $ctx);
1543 sub check_cherry_pick {
1546 my $parents = shift;
1548 my %commits = map { $_ => 1 }
1549 _rev_list("--no-merges", $tip, "--not", $base, @$parents, "--");
1550 for my $range ( @ranges ) {
1551 delete @commits{_rev_list($range, "--")};
1553 for my $commit (keys %commits) {
1554 if (has_no_changes($commit)) {
1555 delete $commits{$commit};
1558 return (keys %commits);
1561 sub has_no_changes {
1564 my @revs = split / /, command_oneline(
1565 qw(rev-list --parents -1 -m), $commit);
1567 # Commits with no parents, e.g. the start of a partial branch,
1568 # have changes by definition.
1569 return 1 if (@revs < 2);
1571 # Commits with multiple parents, e.g a merge, have no changes
1573 return 0 if (@revs > 2);
1575 return (command_oneline("rev-parse", "$commit^{tree}") eq
1576 command_oneline("rev-parse", "$commit~1^{tree}"));
1579 sub tie_for_persistent_memoization {
1583 if ($can_use_yaml) {
1584 tie %$hash => 'Git::SVN::Memoize::YAML', "$path.yaml";
1586 tie %$hash => 'Memoize::Storable', "$path.db", 'nstore';
1590 # The GIT_DIR environment variable is not always set until after the command
1591 # line arguments are processed, so we can't memoize in a BEGIN block.
1595 sub memoize_svn_mergeinfo_functions {
1596 return if $memoized;
1599 my $cache_path = "$ENV{GIT_DIR}/svn/.caches/";
1600 mkpath([$cache_path]) unless -d $cache_path;
1602 my %lookup_svn_merge_cache;
1603 my %check_cherry_pick_cache;
1604 my %has_no_changes_cache;
1606 tie_for_persistent_memoization(\%lookup_svn_merge_cache,
1607 "$cache_path/lookup_svn_merge");
1608 memoize 'lookup_svn_merge',
1609 SCALAR_CACHE => 'FAULT',
1610 LIST_CACHE => ['HASH' => \%lookup_svn_merge_cache],
1613 tie_for_persistent_memoization(\%check_cherry_pick_cache,
1614 "$cache_path/check_cherry_pick");
1615 memoize 'check_cherry_pick',
1616 SCALAR_CACHE => 'FAULT',
1617 LIST_CACHE => ['HASH' => \%check_cherry_pick_cache],
1620 tie_for_persistent_memoization(\%has_no_changes_cache,
1621 "$cache_path/has_no_changes");
1622 memoize 'has_no_changes',
1623 SCALAR_CACHE => ['HASH' => \%has_no_changes_cache],
1624 LIST_CACHE => 'FAULT',
1628 sub unmemoize_svn_mergeinfo_functions {
1629 return if not $memoized;
1632 Memoize::unmemoize 'lookup_svn_merge';
1633 Memoize::unmemoize 'check_cherry_pick';
1634 Memoize::unmemoize 'has_no_changes';
1637 sub clear_memoized_mergeinfo_caches {
1638 die "Only call this method in non-memoized context" if ($memoized);
1640 my $cache_path = "$ENV{GIT_DIR}/svn/.caches/";
1641 return unless -d $cache_path;
1643 for my $cache_file (("$cache_path/lookup_svn_merge",
1644 "$cache_path/check_cherry_pick",
1645 "$cache_path/has_no_changes")) {
1646 for my $suffix (qw(yaml db)) {
1647 my $file = "$cache_file.$suffix";
1648 next unless -e $file;
1649 unlink($file) or die "unlink($file) failed: $!\n";
1655 Memoize::memoize 'Git::SVN::repos_root';
1659 # Force cache writeout explicitly instead of waiting for
1660 # global destruction to avoid segfault in Storable:
1661 # http://rt.cpan.org/Public/Bug/Display.html?id=36087
1662 unmemoize_svn_mergeinfo_functions();
1665 sub parents_exclude {
1666 my $parents = shift;
1668 return unless @commits;
1673 my @cmd = ('rev-list', "-1", @commits, "--not", @$parents );
1674 $excluded = command_oneline(@cmd);
1678 for my $commit ( @commits ) {
1679 if ( $commit eq $excluded ) {
1680 push @excluded, $commit;
1688 die "saw commit '$excluded' in rev-list output, "
1689 ."but we didn't ask for that commit (wanted: @commits --not @$parents)"
1694 while ($excluded and @commits);
1700 # note: this function should only be called if the various dirprops
1701 # have actually changed
1702 sub find_extra_svn_parents {
1703 my ($self, $ed, $mergeinfo, $parents) = @_;
1704 # aha! svk:merge property changed...
1706 memoize_svn_mergeinfo_functions();
1708 # We first search for merged tips which are not in our
1709 # history. Then, we figure out which git revisions are in
1710 # that tip, but not this revision. If all of those revisions
1711 # are now marked as merge, we can add the tip as a parent.
1712 my @merges = split "\n", $mergeinfo;
1714 my $url = $self->url;
1715 my $uuid = $self->ra_uuid;
1717 for my $merge ( @merges ) {
1718 my ($tip_commit, @ranges) =
1719 lookup_svn_merge( $uuid, $url, $merge );
1720 unless (!$tip_commit or
1721 grep { $_ eq $tip_commit } @$parents ) {
1722 push @merge_tips, $tip_commit;
1723 $ranges{$tip_commit} = \@ranges;
1725 push @merge_tips, undef;
1729 my %excluded = map { $_ => 1 }
1730 parents_exclude($parents, grep { defined } @merge_tips);
1732 # check merge tips for new parents
1734 for my $merge_tip ( @merge_tips ) {
1735 my $spec = shift @merges;
1736 next unless $merge_tip and $excluded{$merge_tip};
1738 my $ranges = $ranges{$merge_tip};
1740 # check out 'new' tips
1743 $merge_base = command_oneline(
1745 @$parents, $merge_tip,
1749 die "An error occurred during merge-base"
1750 unless $@->isa("Git::Error::Command");
1752 warn "W: Cannot find common ancestor between ".
1753 "@$parents and $merge_tip. Ignoring merge info.\n";
1757 # double check that there are no missing non-merge commits
1758 my (@incomplete) = check_cherry_pick(
1759 $merge_base, $merge_tip,
1764 if ( @incomplete ) {
1765 warn "W:svn cherry-pick ignored ($spec) - missing "
1766 .@incomplete." commit(s) (eg $incomplete[0])\n";
1769 "Found merge parent (svn:mergeinfo prop): ",
1771 push @new_parents, $merge_tip;
1775 # cater for merges which merge commits from multiple branches
1776 if ( @new_parents > 1 ) {
1777 for ( my $i = 0; $i <= $#new_parents; $i++ ) {
1778 for ( my $j = 0; $j <= $#new_parents; $j++ ) {
1780 next unless $new_parents[$i];
1781 next unless $new_parents[$j];
1782 my $revs = command_oneline(
1784 "$new_parents[$i]..$new_parents[$j]",
1787 undef($new_parents[$j]);
1792 push @$parents, grep { defined } @new_parents;
1795 sub make_log_entry {
1796 my ($self, $rev, $parents, $ed) = @_;
1797 my $untracked = $self->get_untracked($ed);
1799 my @parents = @$parents;
1800 my $ps = $ed->{path_strip} || "";
1801 for my $path ( grep { m/$ps/ } %{$ed->{dir_prop}} ) {
1802 my $props = $ed->{dir_prop}{$path};
1803 if ( $props->{"svk:merge"} ) {
1804 $self->find_extra_svk_parents
1805 ($ed, $props->{"svk:merge"}, \@parents);
1807 if ( $props->{"svn:mergeinfo"} ) {
1808 $self->find_extra_svn_parents
1810 $props->{"svn:mergeinfo"},
1815 open my $un, '>>', "$self->{dir}/unhandled.log" or croak $!;
1816 print $un "r$rev\n" or croak $!;
1817 print $un $_, "\n" foreach @$untracked;
1818 my %log_entry = ( parents => \@parents, revision => $rev,
1822 my $logged = delete $self->{logged_rev_props};
1823 if (!$logged || $self->{-want_revprops}) {
1824 my $rp = $self->ra->rev_proplist($rev);
1825 foreach (sort keys %$rp) {
1827 if (/^svn:(author|date|log)$/) {
1828 $log_entry{$1} = $v;
1829 } elsif ($_ eq 'svm:headrev') {
1832 print $un " rev_prop: ", uri_encode($_), ' ',
1833 uri_encode($v), "\n";
1837 map { $log_entry{$_} = $logged->{$_} } keys %$logged;
1839 close $un or croak $!;
1841 $log_entry{date} = parse_svn_date($log_entry{date});
1842 $log_entry{log} .= "\n";
1843 my $author = $log_entry{author} = check_author($log_entry{author});
1844 my ($name, $email) = defined $::users{$author} ? @{$::users{$author}}
1847 my ($commit_name, $commit_email) = ($name, $email);
1848 if ($_use_log_author) {
1850 if ($log_entry{log} =~ /From:\s+(.*\S)\s*\n/i) {
1852 } elsif ($log_entry{log} =~ /Signed-off-by:\s+(.*\S)\s*\n/i) {
1855 if (!defined $name_field) {
1856 if (!defined $email) {
1859 } elsif ($name_field =~ /(.*?)\s+<(.*)>/) {
1860 ($name, $email) = ($1, $2);
1861 } elsif ($name_field =~ /(.*)@/) {
1862 ($name, $email) = ($1, $name_field);
1864 ($name, $email) = ($name_field, $name_field);
1867 if (defined $headrev && $self->use_svm_props) {
1868 if ($self->rewrite_root) {
1869 die "Can't have both 'useSvmProps' and 'rewriteRoot' ",
1872 if ($self->rewrite_uuid) {
1873 die "Can't have both 'useSvmProps' and 'rewriteUUID' ",
1876 my ($uuid, $r) = $headrev =~ m{^([a-f\d\-]{30,}):(\d+)$}i;
1877 # we don't want "SVM: initializing mirror for junk" ...
1878 return undef if $r == 0;
1879 my $svm = $self->svm;
1880 if ($uuid ne $svm->{uuid}) {
1881 die "UUID mismatch on SVM path:\n",
1882 "expected: $svm->{uuid}\n",
1885 my $full_url = $self->full_url;
1886 $full_url =~ s#^\Q$svm->{replace}\E(/|$)#$svm->{source}$1# or
1887 die "Failed to replace '$svm->{replace}' with ",
1888 "'$svm->{source}' in $full_url\n";
1889 # throw away username for storing in records
1890 remove_username($full_url);
1891 $log_entry{metadata} = "$full_url\@$r $uuid";
1892 $log_entry{svm_revision} = $r;
1893 $email ||= "$author\@$uuid";
1894 $commit_email ||= "$author\@$uuid";
1895 } elsif ($self->use_svnsync_props) {
1896 my $full_url = canonicalize_url(
1897 add_path_to_url( $self->svnsync->{url}, $self->path )
1899 remove_username($full_url);
1900 my $uuid = $self->svnsync->{uuid};
1901 $log_entry{metadata} = "$full_url\@$rev $uuid";
1902 $email ||= "$author\@$uuid";
1903 $commit_email ||= "$author\@$uuid";
1905 my $url = $self->metadata_url;
1906 remove_username($url);
1907 my $uuid = $self->rewrite_uuid || $self->ra->get_uuid;
1908 $log_entry{metadata} = "$url\@$rev " . $uuid;
1909 $email ||= "$author\@" . $uuid;
1910 $commit_email ||= "$author\@" . $uuid;
1912 $log_entry{name} = $name;
1913 $log_entry{email} = $email;
1914 $log_entry{commit_name} = $commit_name;
1915 $log_entry{commit_email} = $commit_email;
1920 my ($self, $min_rev, $max_rev, @parents) = @_;
1921 my ($last_rev, $last_commit) = $self->last_rev_commit;
1922 my ($base, $head) = $self->get_fetch_range($min_rev, $max_rev);
1923 $self->ra->gs_fetch_loop_common($base, $head, [$self]);
1927 my ($self, $log_entry, $tree, $rev, $date, $author) = @_;
1928 $self->{inject_parents} = { $rev => $tree };
1929 $self->fetch(undef, undef);
1933 my ($self, $tree) = (shift, shift);
1934 my $log_entry = ::get_commit_entry($tree);
1935 unless ($self->{last_rev}) {
1936 fatal("Must have an existing revision to commit");
1938 my %ed_opts = ( r => $self->{last_rev},
1939 log => $log_entry->{log},
1941 tree_a => $self->{last_commit},
1944 $self->set_tree_cb($log_entry, $tree, @_) },
1945 svn_path => $self->path );
1946 if (!Git::SVN::Editor->new(\%ed_opts)->apply_diff) {
1947 print "No changes\nr$self->{last_rev} = $tree\n";
1951 sub rebuild_from_rev_db {
1952 my ($self, $path) = @_;
1954 open my $fh, '<', $path or croak "open: $!";
1955 binmode $fh or croak "binmode: $!";
1957 length($_) == 41 or croak "inconsistent size in ($_) != 41";
1960 next if $_ eq ('0' x 40);
1961 $self->rev_map_set($r, $_);
1964 close $fh or croak "close: $!";
1965 unlink $path or croak "unlink: $!";
1970 my $map_path = $self->map_path;
1971 my $partial = (-e $map_path && ! -z $map_path);
1972 return unless ::verify_ref($self->refname.'^0');
1973 if (!$partial && ($self->use_svm_props || $self->no_metadata)) {
1974 my $rev_db = $self->rev_db_path;
1975 $self->rebuild_from_rev_db($rev_db);
1976 if ($self->use_svm_props) {
1977 my $svm_rev_db = $self->rev_db_path($self->svm_uuid);
1978 $self->rebuild_from_rev_db($svm_rev_db);
1980 $self->unlink_rev_db_symlink;
1983 print "Rebuilding $map_path ...\n" if (!$partial);
1984 my ($base_rev, $head) = ($partial ? $self->rev_map_max_norebuild(1) :
1987 command_output_pipe(qw/rev-list --pretty=raw --reverse/,
1988 ($head ? "$head.." : "") . $self->refname,
1990 my $metadata_url = $self->metadata_url;
1991 remove_username($metadata_url);
1992 my $svn_uuid = $self->rewrite_uuid || $self->ra_uuid;
1995 if ( m{^commit ($::sha1)$} ) {
1999 next unless s{^\s*(git-svn-id:)}{$1};
2000 my ($url, $rev, $uuid) = ::extract_metadata($_);
2001 remove_username($url);
2003 # ignore merges (from set-tree)
2004 next if (!defined $rev || !$uuid);
2006 # if we merged or otherwise started elsewhere, this is
2007 # how we break out of it
2008 if (($uuid ne $svn_uuid) ||
2009 ($metadata_url && $url && ($url ne $metadata_url))) {
2012 if ($partial && $head) {
2013 print "Partial-rebuilding $map_path ...\n";
2014 print "Currently at $base_rev = $head\n";
2018 $self->rev_map_set($rev, $c);
2019 print "r$rev = $c\n";
2021 command_close_pipe($log, $ctx);
2022 print "Done rebuilding $map_path\n" if (!$partial || !$head);
2023 my $rev_db_path = $self->rev_db_path;
2024 if (-f $self->rev_db_path) {
2025 unlink $self->rev_db_path or croak "unlink: $!";
2027 $self->unlink_rev_db_symlink;
2031 # Tie::File seems to be prone to offset errors if revisions get sparse,
2032 # it's not that fast, either. Tie::File is also not in Perl 5.6. So
2033 # one of my favorite modules is out :< Next up would be one of the DBM
2034 # modules, but I'm not sure which is most portable...
2036 # This is the replacement for the rev_db format, which was too big
2037 # and inefficient for large repositories with a lot of sparse history
2040 # The format is this:
2041 # - 24 bytes for every record,
2042 # * 4 bytes for the integer representing an SVN revision number
2043 # * 20 bytes representing the sha1 of a git commit
2044 # - No empty padding records like the old format
2045 # (except the last record, which can be overwritten)
2046 # - new records are written append-only since SVN revision numbers
2047 # increase monotonically
2048 # - lookups on SVN revision number are done via a binary search
2049 # - Piping the file to xxd -c24 is a good way of dumping it for
2050 # viewing or editing (piped back through xxd -r), should the need
2052 # - The last record can be padding revision with an all-zero sha1
2053 # This is used to optimize fetch performance when using multiple
2054 # "fetch" directives in .git/config
2056 # These files are disposable unless noMetadata or useSvmProps is set
2059 my ($fh, $rev, $commit) = @_;
2061 binmode $fh or croak "binmode: $!";
2062 my $size = (stat($fh))[7];
2063 ($size % 24) == 0 or croak "inconsistent size: $size";
2067 sysseek($fh, -24, SEEK_END) or croak "seek: $!";
2068 my $read = sysread($fh, my $buf, 24) or croak "read: $!";
2069 $read == 24 or croak "read only $read bytes (!= 24)";
2070 my ($last_rev, $last_commit) = unpack(rev_map_fmt, $buf);
2071 if ($last_commit eq ('0' x40)) {
2073 sysseek($fh, -48, SEEK_END) or croak "seek: $!";
2074 $read = sysread($fh, $buf, 24) or
2077 croak "read only $read bytes (!= 24)";
2078 ($last_rev, $last_commit) =
2079 unpack(rev_map_fmt, $buf);
2080 if ($last_commit eq ('0' x40)) {
2081 croak "inconsistent .rev_map\n";
2084 if ($last_rev >= $rev) {
2085 croak "last_rev is higher!: $last_rev >= $rev";
2090 sysseek($fh, $wr_offset, SEEK_END) or croak "seek: $!";
2091 syswrite($fh, pack(rev_map_fmt, $rev, $commit), 24) == 24 or
2095 sub _rev_map_reset {
2096 my ($fh, $rev, $commit) = @_;
2097 my $c = _rev_map_get($fh, $rev);
2098 $c eq $commit or die "_rev_map_reset(@_) commit $c does not match!\n";
2099 my $offset = sysseek($fh, 0, SEEK_CUR) or croak "seek: $!";
2100 truncate $fh, $offset or croak "truncate: $!";
2106 my ($dir, $base) = ($path =~ m#^(.*?)/?([^/]+)$#);
2107 mkpath([$dir]) unless -d $dir;
2108 open my $fh, '>>', $path or die "Couldn't create $path: $!\n";
2109 close $fh or die "Couldn't close (create) $path: $!\n";
2114 my ($self, $rev, $commit, $update_ref, $uuid) = @_;
2115 defined $commit or die "missing arg3\n";
2116 length $commit == 40 or die "arg3 must be a full SHA1 hexsum\n";
2117 my $db = $self->map_path($uuid);
2118 my $db_lock = "$db.lock";
2122 $sigmask = POSIX::SigSet->new();
2123 my $signew = POSIX::SigSet->new(SIGINT, SIGHUP, SIGTERM,
2124 SIGALRM, SIGUSR1, SIGUSR2);
2125 sigprocmask(SIG_BLOCK, $signew, $sigmask) or
2126 croak "Can't block signals: $!";
2130 $LOCKFILES{$db_lock} = 1;
2132 # both of these options make our .rev_db file very, very important
2133 # and we can't afford to lose it because rebuild() won't work
2134 if ($self->use_svm_props || $self->no_metadata) {
2136 copy($db, $db_lock) or die "rev_map_set(@_): ",
2138 "$db => $db_lock ($!)\n";
2140 rename $db, $db_lock or die "rev_map_set(@_): ",
2141 "Failed to rename: ",
2142 "$db => $db_lock ($!)\n";
2145 sysopen(my $fh, $db_lock, O_RDWR | O_CREAT)
2146 or croak "Couldn't open $db_lock: $!\n";
2147 if ($update_ref eq 'reset') {
2148 clear_memoized_mergeinfo_caches();
2149 _rev_map_reset($fh, $rev, $commit);
2151 _rev_map_set($fh, $rev, $commit);
2155 $fh->flush or die "Couldn't flush $db_lock: $!\n";
2156 $fh->sync or die "Couldn't sync $db_lock: $!\n";
2158 close $fh or croak $!;
2162 $note = " ($update_ref)" if ($update_ref !~ /^\d*$/);
2163 command_noisy('update-ref', '-m', "r$rev$note",
2164 $self->refname, $commit);
2166 rename $db_lock, $db or die "rev_map_set(@_): ", "Failed to rename: ",
2167 "$db_lock => $db ($!)\n";
2168 delete $LOCKFILES{$db_lock};
2170 sigprocmask(SIG_SETMASK, $sigmask) or
2171 croak "Can't restore signal mask: $!";
2175 # If want_commit, this will return an array of (rev, commit) where
2176 # commit _must_ be a valid commit in the archive.
2177 # Otherwise, it'll return the max revision (whether or not the
2178 # commit is valid or just a 0x40 placeholder).
2180 my ($self, $want_commit) = @_;
2182 my ($r, $c) = $self->rev_map_max_norebuild($want_commit);
2183 $want_commit ? ($r, $c) : $r;
2186 sub rev_map_max_norebuild {
2187 my ($self, $want_commit) = @_;
2188 my $map_path = $self->map_path;
2189 stat $map_path or return $want_commit ? (0, undef) : 0;
2190 sysopen(my $fh, $map_path, O_RDONLY) or croak "open: $!";
2191 binmode $fh or croak "binmode: $!";
2192 my $size = (stat($fh))[7];
2193 ($size % 24) == 0 or croak "inconsistent size: $size";
2196 close $fh or croak "close: $!";
2197 return $want_commit ? (0, undef) : 0;
2200 sysseek($fh, -24, SEEK_END) or croak "seek: $!";
2201 sysread($fh, my $buf, 24) == 24 or croak "read: $!";
2202 my ($r, $c) = unpack(rev_map_fmt, $buf);
2203 if ($want_commit && $c eq ('0' x40)) {
2205 return $want_commit ? (0, undef) : 0;
2207 sysseek($fh, -48, SEEK_END) or croak "seek: $!";
2208 sysread($fh, $buf, 24) == 24 or croak "read: $!";
2209 ($r, $c) = unpack(rev_map_fmt, $buf);
2210 if ($c eq ('0'x40)) {
2211 croak "Penultimate record is all-zeroes in $map_path";
2214 close $fh or croak "close: $!";
2215 $want_commit ? ($r, $c) : $r;
2219 my ($self, $rev, $uuid) = @_;
2220 my $map_path = $self->map_path($uuid);
2221 return undef unless -e $map_path;
2223 sysopen(my $fh, $map_path, O_RDONLY) or croak "open: $!";
2224 my $c = _rev_map_get($fh, $rev);
2225 close($fh) or croak "close: $!";
2230 my ($fh, $rev) = @_;
2232 binmode $fh or croak "binmode: $!";
2233 my $size = (stat($fh))[7];
2234 ($size % 24) == 0 or croak "inconsistent size: $size";
2240 my ($l, $u) = (0, $size - 24);
2244 my $i = int(($l/24 + $u/24) / 2) * 24;
2245 sysseek($fh, $i, SEEK_SET) or croak "seek: $!";
2246 sysread($fh, my $buf, 24) == 24 or croak "read: $!";
2247 my ($r, $c) = unpack(rev_map_fmt, $buf);
2251 } elsif ($r > $rev) {
2253 } else { # $r == $rev
2254 return $c eq ('0' x 40) ? undef : $c;
2260 # Finds the first svn revision that exists on (if $eq_ok is true) or
2261 # before $rev for the current branch. It will not search any lower
2262 # than $min_rev. Returns the git commit hash and svn revision number
2263 # if found, else (undef, undef).
2264 sub find_rev_before {
2265 my ($self, $rev, $eq_ok, $min_rev) = @_;
2266 --$rev unless $eq_ok;
2268 my $max_rev = $self->rev_map_max;
2269 $rev = $max_rev if ($rev > $max_rev);
2270 while ($rev >= $min_rev) {
2271 if (my $c = $self->rev_map_get($rev)) {
2276 return (undef, undef);
2279 # Finds the first svn revision that exists on (if $eq_ok is true) or
2280 # after $rev for the current branch. It will not search any higher
2281 # than $max_rev. Returns the git commit hash and svn revision number
2282 # if found, else (undef, undef).
2283 sub find_rev_after {
2284 my ($self, $rev, $eq_ok, $max_rev) = @_;
2285 ++$rev unless $eq_ok;
2286 $max_rev ||= $self->rev_map_max;
2287 while ($rev <= $max_rev) {
2288 if (my $c = $self->rev_map_get($rev)) {
2293 return (undef, undef);
2297 my ($class, $repo_id, $ref_id, $path) = @_;
2298 unless (defined $repo_id && length $repo_id) {
2299 $repo_id = $default_repo_id;
2301 unless (defined $ref_id && length $ref_id) {
2302 # Access the prefix option from the git-svn main program if it's loaded.
2303 my $prefix = defined &::opt_prefix ? ::opt_prefix() : "";
2305 "refs/remotes/$prefix$default_ref_id";
2308 my $dir = "$ENV{GIT_DIR}/svn/$ref_id";
2310 # Older repos imported by us used $GIT_DIR/svn/foo instead of
2311 # $GIT_DIR/svn/refs/remotes/foo when tracking refs/remotes/foo
2312 if ($ref_id =~ m{^refs/remotes/(.*)}) {
2313 my $old_dir = "$ENV{GIT_DIR}/svn/$1";
2314 if (-d $old_dir && ! -d $dir) {
2319 $_[3] = $path = '' unless (defined $path);
2322 ref_id => $ref_id, dir => $dir, index => "$dir/index",
2323 config => "$ENV{GIT_DIR}/svn/config",
2324 map_root => "$dir/.rev_map", repo_id => $repo_id }, $class;
2326 # Ensure it gets canonicalized
2337 $self->{path} = canonicalize_path($path);
2341 return $self->{path};
2349 $self->{url} = canonicalize_url($url);
2353 return $self->{url};
2356 # for read-only access of old .rev_db formats
2357 sub unlink_rev_db_symlink {
2359 my $link = $self->rev_db_path;
2360 $link =~ s/\.[\w-]+$// or croak "missing UUID at the end of $link";
2362 unlink $link or croak "unlink: $link failed!";
2367 my ($self, $uuid) = @_;
2368 my $db_path = $self->map_path($uuid);
2369 $db_path =~ s{/\.rev_map\.}{/\.rev_db\.}
2370 or croak "map_path: $db_path does not contain '/.rev_map.' !";
2374 # the new replacement for .rev_db
2376 my ($self, $uuid) = @_;
2377 $uuid ||= $self->ra_uuid;
2378 "$self->{map_root}.$uuid";
2383 $f =~ s#([^a-zA-Z0-9\*!\:_\./\-])#uc sprintf("%%%02x",ord($1))#eg;
2389 $f =~ s#%([0-9a-fA-F]{2})#chr(hex($1))#eg;
2393 sub remove_username {
2394 $_[0] =~ s{^([^:]*://)[^@]+@}{$1};