dgit

   1 #!/usr/bin/perl -w
   2 # dgit
   3 # Integration between git and Debian-style archives
   4 #
   5 # Copyright (C)2013-2016 Ian Jackson
   6 #
   7 # This program is free software: you can redistribute it and/or modify
   8 # it under the terms of the GNU General Public License as published by
   9 # the Free Software Foundation, either version 3 of the License, or
  10 # (at your option) any later version.
  11 #
  12 # This program is distributed in the hope that it will be useful,
  13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 # GNU General Public License for more details.
  16 #
  17 # You should have received a copy of the GNU General Public License
  18 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19
  20 use strict;
  21
  22 use Debian::Dgit;
  23 setup_sigwarn();
  24
  25 use IO::Handle;
  26 use Data::Dumper;
  27 use LWP::UserAgent;
  28 use Dpkg::Control::Hash;
  29 use File::Path;
  30 use File::Temp qw(tempdir);
  31 use File::Basename;
  32 use Dpkg::Version;
  33 use POSIX;
  34 use IPC::Open2;
  35 use Digest::SHA;
  36 use Digest::MD5;
  37 use List::MoreUtils qw(pairwise);
  38 use Text::Glob qw(match_glob);
  39 use Fcntl qw(:DEFAULT :flock);
  40 use Carp;
  41
  42 use Debian::Dgit;
  43
  44 our $our_version = 'UNRELEASED'; ###substituted###
  45 our $absurdity = undef; ###substituted###
  46
  47 our @rpushprotovsn_support = qw(4 3 2); # 4 is new tag format
  48 our $protovsn;
  49
  50 our $isuite;
  51 our $idistro;
  52 our $package;
  53 our @ropts;
  54
  55 our $sign = 1;
  56 our $dryrun_level = 0;
  57 our $changesfile;
  58 our $buildproductsdir = '..';
  59 our $new_package = 0;
  60 our $ignoredirty = 0;
  61 our $rmonerror = 1;
  62 our @deliberatelies;
  63 our %previously;
  64 our $existing_package = 'dpkg';
  65 our $cleanmode;
  66 our $changes_since_version;
  67 our $rmchanges;
  68 our $overwrite_version; # undef: not specified; '': check changelog
  69 our $quilt_mode;
  70 our $quilt_modes_re = 'linear|smash|auto|nofix|nocheck|gbp|dpm|unapplied';
  71 our $dodep14tag;
  72 our $split_brain_save;
  73 our $we_are_responder;
  74 our $we_are_initiator;
  75 our $initiator_tempdir;
  76 our $patches_applied_dirtily = 00;
  77 our $tagformat_want;
  78 our $tagformat;
  79 our $tagformatfn;
  80 our $chase_dsc_distro=1;
  81
  82 our %forceopts = map { $_=>0 }
  83     qw(unrepresentable unsupported-source-format
  84        dsc-changes-mismatch changes-origs-exactly
  85        import-gitapply-absurd
  86        import-gitapply-no-absurd
  87        import-dsc-with-dgit-field);
  88
  89 our %format_ok = map { $_=>1 } ("1.0","3.0 (native)","3.0 (quilt)");
  90
  91 our $suite_re = '[-+.0-9a-z]+';
  92 our $cleanmode_re = 'dpkg-source(?:-d)?|git|git-ff|check|none';
  93 our $orig_f_comp_re = 'orig(?:-[-0-9a-z]+)?';
  94 our $orig_f_sig_re = '\\.(?:asc|gpg|pgp)';
  95 our $orig_f_tail_re = "$orig_f_comp_re\\.tar(?:\\.\\w+)?(?:$orig_f_sig_re)?";
  96
  97 our $git_authline_re = '^([^<>]+) \<(\S+)\> (\d+ [-+]\d+)$';
  98 our $splitbraincache = 'dgit-intern/quilt-cache';
  99 our $rewritemap = 'dgit-rewrite/map';
 100
 101 our (@git) = qw(git);
 102 our (@dget) = qw(dget);
 103 our (@curl) = qw(curl);
 104 our (@dput) = qw(dput);
 105 our (@debsign) = qw(debsign);
 106 our (@gpg) = qw(gpg);
 107 our (@sbuild) = qw(sbuild);
 108 our (@ssh) = 'ssh';
 109 our (@dgit) = qw(dgit);
 110 our (@aptget) = qw(apt-get);
 111 our (@aptcache) = qw(apt-cache);
 112 our (@dpkgbuildpackage) = qw(dpkg-buildpackage -i\.git/ -I.git);
 113 our (@dpkgsource) = qw(dpkg-source -i\.git/ -I.git);
 114 our (@dpkggenchanges) = qw(dpkg-genchanges);
 115 our (@mergechanges) = qw(mergechanges -f);
 116 our (@gbp_build) = ('');
 117 our (@gbp_pq) = ('gbp pq');
 118 our (@changesopts) = ('');
 119
 120 our %opts_opt_map = ('dget' => \@dget, # accept for compatibility
 121                      'curl' => \@curl,
 122                      'dput' => \@dput,
 123                      'debsign' => \@debsign,
 124                      'gpg' => \@gpg,
 125                      'sbuild' => \@sbuild,
 126                      'ssh' => \@ssh,
 127                      'dgit' => \@dgit,
 128                      'git' => \@git,
 129                      'apt-get' => \@aptget,
 130                      'apt-cache' => \@aptcache,
 131                      'dpkg-source' => \@dpkgsource,
 132                      'dpkg-buildpackage' => \@dpkgbuildpackage,
 133                      'dpkg-genchanges' => \@dpkggenchanges,
 134                      'gbp-build' => \@gbp_build,
 135                      'gbp-pq' => \@gbp_pq,
 136                      'ch' => \@changesopts,
 137                      'mergechanges' => \@mergechanges);
 138
 139 our %opts_opt_cmdonly = ('gpg' => 1, 'git' => 1);
 140 our %opts_cfg_insertpos = map {
 141     $_,
 142     scalar @{ $opts_opt_map{$_} }
 143 } keys %opts_opt_map;
 144
 145 sub parseopts_late_defaults();
 146 sub setup_gitattrs(;$);
 147 sub check_gitattrs($$);
 148
 149 our $keyid;
 150
 151 autoflush STDOUT 1;
 152
 153 our $supplementary_message = '';
 154 our $need_split_build_invocation = 0;
 155 our $split_brain = 0;
 156
 157 END {
 158     local ($@, $?);
 159     return unless forkcheck_mainprocess();
 160     print STDERR "! $_\n" foreach $supplementary_message =~ m/^.+$/mg;
 161 }
 162
 163 our $remotename = 'dgit';
 164 our @ourdscfield = qw(Dgit Vcs-Dgit-Master);
 165 our $csuite;
 166 our $instead_distro;
 167
 168 if (!defined $absurdity) {
 169     $absurdity = $0;
 170     $absurdity =~ s{/[^/]+$}{/absurd} or die;
 171 }
 172
 173 sub debiantag ($$) {
 174     my ($v,$distro) = @_;
 175     return $tagformatfn->($v, $distro);
 176 }
 177
 178 sub debiantag_maintview ($$) {
 179     my ($v,$distro) = @_;
 180     return "$distro/".dep14_version_mangle $v;
 181 }
 182
 183 sub madformat ($) { $_[0] eq '3.0 (quilt)' }
 184
 185 sub lbranch () { return "$branchprefix/$csuite"; }
 186 my $lbranch_re = '^refs/heads/'.$branchprefix.'/([^/.]+)$';
 187 sub lref () { return "refs/heads/".lbranch(); }
 188 sub lrref () { return "refs/remotes/$remotename/".server_branch($csuite); }
 189 sub rrref () { return server_ref($csuite); }
 190
 191 sub stripepoch ($) {
 192     my ($vsn) = @_;
 193     $vsn =~ s/^\d+\://;
 194     return $vsn;
 195 }
 196
 197 sub srcfn ($$) {
 198     my ($vsn,$sfx) = @_;
 199     return "${package}_".(stripepoch $vsn).$sfx
 200 }
 201
 202 sub dscfn ($) {
 203     my ($vsn) = @_;
 204     return srcfn($vsn,".dsc");
 205 }
 206
 207 sub changespat ($;$) {
 208     my ($vsn, $arch) = @_;
 209     return "${package}_".(stripepoch $vsn)."_".($arch//'*').".changes";
 210 }
 211
 212 sub upstreamversion ($) {
 213     my ($vsn) = @_;
 214     $vsn =~ s/-[^-]+$//;
 215     return $vsn;
 216 }
 217
 218 our $us = 'dgit';
 219 initdebug('');
 220
 221 our @end;
 222 END {
 223     local ($?);
 224     return unless forkcheck_mainprocess();
 225     foreach my $f (@end) {
 226         eval { $f->(); };
 227         print STDERR "$us: cleanup: $@" if length $@;
 228     }
 229 };
 230
 231 sub badcfg { print STDERR "$us: invalid configuration: @_\n"; exit 12; }
 232
 233 sub forceable_fail ($$) {
 234     my ($forceoptsl, $msg) = @_;
 235     fail $msg unless grep { $forceopts{$_} } @$forceoptsl;
 236     print STDERR "warning: overriding problem due to --force:\n". $msg;
 237 }
 238
 239 sub forceing ($) {
 240     my ($forceoptsl) = @_;
 241     my @got = grep { $forceopts{$_} } @$forceoptsl;
 242     return 0 unless @got;
 243     print STDERR
 244  "warning: skipping checks or functionality due to --force-$got[0]\n";
 245 }
 246
 247 sub no_such_package () {
 248     print STDERR "$us: package $package does not exist in suite $isuite\n";
 249     exit 4;
 250 }
 251
 252 sub changedir ($) {
 253     my ($newdir) = @_;
 254     printdebug "CD $newdir\n";
 255     chdir $newdir or confess "chdir: $newdir: $!";
 256 }
 257
 258 sub deliberately ($) {
 259     my ($enquiry) = @_;
 260     return !!grep { $_ eq "--deliberately-$enquiry" } @deliberatelies;
 261 }
 262
 263 sub deliberately_not_fast_forward () {
 264     foreach (qw(not-fast-forward fresh-repo)) {
 265         return 1 if deliberately($_) || deliberately("TEST-dgit-only-$_");
 266     }
 267 }
 268
 269 sub quiltmode_splitbrain () {
 270     $quilt_mode =~ m/gbp|dpm|unapplied/;
 271 }
 272
 273 sub opts_opt_multi_cmd {
 274     my @cmd;
 275     push @cmd, split /\s+/, shift @_;
 276     push @cmd, @_;
 277     @cmd;
 278 }
 279
 280 sub gbp_pq {
 281     return opts_opt_multi_cmd @gbp_pq;
 282 }
 283
 284 #---------- remote protocol support, common ----------
 285
 286 # remote push initiator/responder protocol:
 287 #  $ dgit remote-push-build-host <n-rargs> <rargs>... <push-args>...
 288 #  where <rargs> is <push-host-dir> <supported-proto-vsn>,... ...
 289 #  < dgit-remote-push-ready <actual-proto-vsn>
 290 #
 291 # occasionally:
 292 #
 293 #  > progress NBYTES
 294 #  [NBYTES message]
 295 #
 296 #  > supplementary-message NBYTES          # $protovsn >= 3
 297 #  [NBYTES message]
 298 #
 299 # main sequence:
 300 #
 301 #  > file parsed-changelog
 302 #  [indicates that output of dpkg-parsechangelog follows]
 303 #  > data-block NBYTES
 304 #  > [NBYTES bytes of data (no newline)]
 305 #  [maybe some more blocks]
 306 #  > data-end
 307 #
 308 #  > file dsc
 309 #  [etc]
 310 #
 311 #  > file changes
 312 #  [etc]
 313 #
 314 #  > param head DGIT-VIEW-HEAD
 315 #  > param csuite SUITE
 316 #  > param tagformat old|new
 317 #  > param maint-view MAINT-VIEW-HEAD
 318 #
 319 #  > previously REFNAME=OBJNAME       # if --deliberately-not-fast-forward
 320 #                                     # goes into tag, for replay prevention
 321 #
 322 #  > want signed-tag
 323 #  [indicates that signed tag is wanted]
 324 #  < data-block NBYTES
 325 #  < [NBYTES bytes of data (no newline)]
 326 #  [maybe some more blocks]
 327 #  < data-end
 328 #  < files-end
 329 #
 330 #  > want signed-dsc-changes
 331 #  < data-block NBYTES    [transfer of signed dsc]
 332 #  [etc]
 333 #  < data-block NBYTES    [transfer of signed changes]
 334 #  [etc]
 335 #  < files-end
 336 #
 337 #  > complete
 338
 339 our $i_child_pid;
 340
 341 sub i_child_report () {
 342     # Sees if our child has died, and reap it if so.  Returns a string
 343     # describing how it died if it failed, or undef otherwise.
 344     return undef unless $i_child_pid;
 345     my $got = waitpid $i_child_pid, WNOHANG;
 346     return undef if $got <= 0;
 347     die unless $got == $i_child_pid;
 348     $i_child_pid = undef;
 349     return undef unless $?;
 350     return "build host child ".waitstatusmsg();
 351 }
 352
 353 sub badproto ($$) {
 354     my ($fh, $m) = @_;
 355     fail "connection lost: $!" if $fh->error;
 356     fail "protocol violation; $m not expected";
 357 }
 358
 359 sub badproto_badread ($$) {
 360     my ($fh, $wh) = @_;
 361     fail "connection lost: $!" if $!;
 362     my $report = i_child_report();
 363     fail $report if defined $report;
 364     badproto $fh, "eof (reading $wh)";
 365 }
 366
 367 sub protocol_expect (&$) {
 368     my ($match, $fh) = @_;
 369     local $_;
 370     $_ = <$fh>;
 371     defined && chomp or badproto_badread $fh, "protocol message";
 372     if (wantarray) {
 373         my @r = &$match;
 374         return @r if @r;
 375     } else {
 376         my $r = &$match;
 377         return $r if $r;
 378     }
 379     badproto $fh, "\`$_'";
 380 }
 381
 382 sub protocol_send_file ($$) {
 383     my ($fh, $ourfn) = @_;
 384     open PF, "<", $ourfn or die "$ourfn: $!";
 385     for (;;) {
 386         my $d;
 387         my $got = read PF, $d, 65536;
 388         die "$ourfn: $!" unless defined $got;
 389         last if !$got;
 390         print $fh "data-block ".length($d)."\n" or die $!;
 391         print $fh $d or die $!;
 392     }
 393     PF->error and die "$ourfn $!";
 394     print $fh "data-end\n" or die $!;
 395     close PF;
 396 }
 397
 398 sub protocol_read_bytes ($$) {
 399     my ($fh, $nbytes) = @_;
 400     $nbytes =~ m/^[1-9]\d{0,5}$|^0$/ or badproto \*RO, "bad byte count";
 401     my $d;
 402     my $got = read $fh, $d, $nbytes;
 403     $got==$nbytes or badproto_badread $fh, "data block";
 404     return $d;
 405 }
 406
 407 sub protocol_receive_file ($$) {
 408     my ($fh, $ourfn) = @_;
 409     printdebug "() $ourfn\n";
 410     open PF, ">", $ourfn or die "$ourfn: $!";
 411     for (;;) {
 412         my ($y,$l) = protocol_expect {
 413             m/^data-block (.*)$/ ? (1,$1) :
 414             m/^data-end$/ ? (0,) :
 415             ();
 416         } $fh;
 417         last unless $y;
 418         my $d = protocol_read_bytes $fh, $l;
 419         print PF $d or die $!;
 420     }
 421     close PF or die $!;
 422 }
 423
 424 #---------- remote protocol support, responder ----------
 425
 426 sub responder_send_command ($) {
 427     my ($command) = @_;
 428     return unless $we_are_responder;
 429     # called even without $we_are_responder
 430     printdebug ">> $command\n";
 431     print PO $command, "\n" or die $!;
 432 }
 433
 434 sub responder_send_file ($$) {
 435     my ($keyword, $ourfn) = @_;
 436     return unless $we_are_responder;
 437     printdebug "]] $keyword $ourfn\n";
 438     responder_send_command "file $keyword";
 439     protocol_send_file \*PO, $ourfn;
 440 }
 441
 442 sub responder_receive_files ($@) {
 443     my ($keyword, @ourfns) = @_;
 444     die unless $we_are_responder;
 445     printdebug "[[ $keyword @ourfns\n";
 446     responder_send_command "want $keyword";
 447     foreach my $fn (@ourfns) {
 448         protocol_receive_file \*PI, $fn;
 449     }
 450     printdebug "[[\$\n";
 451     protocol_expect { m/^files-end$/ } \*PI;
 452 }
 453
 454 #---------- remote protocol support, initiator ----------
 455
 456 sub initiator_expect (&) {
 457     my ($match) = @_;
 458     protocol_expect { &$match } \*RO;
 459 }
 460
 461 #---------- end remote code ----------
 462
 463 sub progress {
 464     if ($we_are_responder) {
 465         my $m = join '', @_;
 466         responder_send_command "progress ".length($m) or die $!;
 467         print PO $m or die $!;
 468     } else {
 469         print @_, "\n";
 470     }
 471 }
 472
 473 our $ua;
 474
 475 sub url_get {
 476     if (!$ua) {
 477         $ua = LWP::UserAgent->new();
 478         $ua->env_proxy;
 479     }
 480     my $what = $_[$#_];
 481     progress "downloading $what...";
 482     my $r = $ua->get(@_) or die $!;
 483     return undef if $r->code == 404;
 484     $r->is_success or fail "failed to fetch $what: ".$r->status_line;
 485     return $r->decoded_content(charset => 'none');
 486 }
 487
 488 our ($dscdata,$dscurl,$dsc,$dsc_checked,$skew_warning_vsn);
 489
 490 sub runcmd {
 491     debugcmd "+",@_;
 492     $!=0; $?=-1;
 493     failedcmd @_ if system @_;
 494 }
 495
 496 sub act_local () { return $dryrun_level <= 1; }
 497 sub act_scary () { return !$dryrun_level; }
 498
 499 sub printdone {
 500     if (!$dryrun_level) {
 501         progress "$us ok: @_";
 502     } else {
 503         progress "would be ok: @_ (but dry run only)";
 504     }
 505 }
 506
 507 sub dryrun_report {
 508     printcmd(\*STDERR,$debugprefix."#",@_);
 509 }
 510
 511 sub runcmd_ordryrun {
 512     if (act_scary()) {
 513         runcmd @_;
 514     } else {
 515         dryrun_report @_;
 516     }
 517 }
 518
 519 sub runcmd_ordryrun_local {
 520     if (act_local()) {
 521         runcmd @_;
 522     } else {
 523         dryrun_report @_;
 524     }
 525 }
 526
 527 sub shell_cmd {
 528     my ($first_shell, @cmd) = @_;
 529     return qw(sh -ec), $first_shell.'; exec "$@"', 'x', @cmd;
 530 }
 531
 532 our $helpmsg = <<END;
 533 main usages:
 534   dgit [dgit-opts] clone [dgit-opts] package [suite] [./dir|/dir]
 535   dgit [dgit-opts] fetch|pull [dgit-opts] [suite]
 536   dgit [dgit-opts] build [dpkg-buildpackage-opts]
 537   dgit [dgit-opts] sbuild [sbuild-opts]
 538   dgit [dgit-opts] push [dgit-opts] [suite]
 539   dgit [dgit-opts] rpush build-host:build-dir ...
 540 important dgit options:
 541   -k<keyid>           sign tag and package with <keyid> instead of default
 542   --dry-run -n        do not change anything, but go through the motions
 543   --damp-run -L       like --dry-run but make local changes, without signing
 544   --new -N            allow introducing a new package
 545   --debug -D          increase debug level
 546   -c<name>=<value>    set git config option (used directly by dgit too)
 547 END
 548
 549 our $later_warning_msg = <<END;
 550 Perhaps the upload is stuck in incoming.  Using the version from git.
 551 END
 552
 553 sub badusage {
 554     print STDERR "$us: @_\n", $helpmsg or die $!;
 555     exit 8;
 556 }
 557
 558 sub nextarg {
 559     @ARGV or badusage "too few arguments";
 560     return scalar shift @ARGV;
 561 }
 562
 563 sub cmd_help () {
 564     print $helpmsg or die $!;
 565     exit 0;
 566 }
 567
 568 our $td = $ENV{DGIT_TEST_DUMMY_DIR} || "DGIT_TEST_DUMMY_DIR-unset";
 569
 570 our %defcfg = ('dgit.default.distro' => 'debian',
 571                'dgit.default.default-suite' => 'unstable',
 572                'dgit.default.old-dsc-distro' => 'debian',
 573                'dgit-suite.*-security.distro' => 'debian-security',
 574                'dgit.default.username' => '',
 575                'dgit.default.archive-query-default-component' => 'main',
 576                'dgit.default.ssh' => 'ssh',
 577                'dgit.default.archive-query' => 'madison:',
 578                'dgit.default.sshpsql-dbname' => 'service=projectb',
 579                'dgit.default.aptget-components' => 'main',
 580                'dgit.default.dgit-tag-format' => 'new,old,maint',
 581                'dgit.dsc-url-proto-ok.http'    => 'true',
 582                'dgit.dsc-url-proto-ok.https'   => 'true',
 583                'dgit.dsc-url-proto-ok.git'     => 'true',
 584                'dgit.default.dsc-url-proto-ok' => 'false',
 585                # old means "repo server accepts pushes with old dgit tags"
 586                # new means "repo server accepts pushes with new dgit tags"
 587                # maint means "repo server accepts split brain pushes"
 588                # hist means "repo server may have old pushes without new tag"
 589                #   ("hist" is implied by "old")
 590                'dgit-distro.debian.archive-query' => 'ftpmasterapi:',
 591                'dgit-distro.debian.git-check' => 'url',
 592                'dgit-distro.debian.git-check-suffix' => '/info/refs',
 593                'dgit-distro.debian.new-private-pushers' => 't',
 594                'dgit-distro.debian/push.git-url' => '',
 595                'dgit-distro.debian/push.git-host' => 'push.dgit.debian.org',
 596                'dgit-distro.debian/push.git-user-force' => 'dgit',
 597                'dgit-distro.debian/push.git-proto' => 'git+ssh://',
 598                'dgit-distro.debian/push.git-path' => '/dgit/debian/repos',
 599                'dgit-distro.debian/push.git-create' => 'true',
 600                'dgit-distro.debian/push.git-check' => 'ssh-cmd',
 601  'dgit-distro.debian.archive-query-url', 'https://api.ftp-master.debian.org/',
 602 # 'dgit-distro.debian.archive-query-tls-key',
 603 #    '/etc/ssl/certs/%HOST%.pem:/etc/dgit/%HOST%.pem',
 604 # ^ this does not work because curl is broken nowadays
 605 # Fixing #790093 properly will involve providing providing the key
 606 # in some pacagke and maybe updating these paths.
 607 #
 608 # 'dgit-distro.debian.archive-query-tls-curl-args',
 609 #   '--ca-path=/etc/ssl/ca-debian',
 610 # ^ this is a workaround but works (only) on DSA-administered machines
 611                'dgit-distro.debian.git-url' => 'https://git.dgit.debian.org',
 612                'dgit-distro.debian.git-url-suffix' => '',
 613                'dgit-distro.debian.upload-host' => 'ftp-master', # for dput
 614                'dgit-distro.debian.mirror' => 'http://ftp.debian.org/debian/',
 615  'dgit-distro.debian-security.archive-query' => 'aptget:',
 616  'dgit-distro.debian-security.mirror' => 'http://security.debian.org/debian-security/',
 617  'dgit-distro.debian-security.aptget-suite-map' => 's#-security$#/updates#',
 618  'dgit-distro.debian-security.aptget-suite-rmap' => 's#$#-security#',
 619  'dgit-distro.debian-security.nominal-distro' => 'debian',
 620  'dgit-distro.debian.backports-quirk' => '(squeeze)-backports*',
 621  'dgit-distro.debian-backports.mirror' => 'http://backports.debian.org/debian-backports/',
 622                'dgit-distro.ubuntu.git-check' => 'false',
 623  'dgit-distro.ubuntu.mirror' => 'http://archive.ubuntu.com/ubuntu',
 624                'dgit-distro.test-dummy.ssh' => "$td/ssh",
 625                'dgit-distro.test-dummy.username' => "alice",
 626                'dgit-distro.test-dummy.git-check' => "ssh-cmd",
 627                'dgit-distro.test-dummy.git-create' => "ssh-cmd",
 628                'dgit-distro.test-dummy.git-url' => "$td/git",
 629                'dgit-distro.test-dummy.git-host' => "git",
 630                'dgit-distro.test-dummy.git-path' => "$td/git",
 631                'dgit-distro.test-dummy.archive-query' => "dummycatapi:",
 632                'dgit-distro.test-dummy.archive-query-url' => "file://$td/aq/",
 633                'dgit-distro.test-dummy.mirror' => "file://$td/mirror/",
 634                'dgit-distro.test-dummy.upload-host' => 'test-dummy',
 635                );
 636
 637 our %gitcfgs;
 638 our @gitcfgsources = qw(cmdline local global system);
 639
 640 sub git_slurp_config () {
 641     local ($debuglevel) = $debuglevel-2;
 642     local $/="\0";
 643
 644     # This algoritm is a bit subtle, but this is needed so that for
 645     # options which we want to be single-valued, we allow the
 646     # different config sources to override properly.  See #835858.
 647     foreach my $src (@gitcfgsources) {
 648         next if $src eq 'cmdline';
 649         # we do this ourselves since git doesn't handle it
 650
 651         my @cmd = (@git, qw(config -z --get-regexp), "--$src", qw(.*));
 652         debugcmd "|",@cmd;
 653
 654         open GITS, "-|", @cmd or die $!;
 655         while (<GITS>) {
 656             chomp or die;
 657             printdebug "=> ", (messagequote $_), "\n";
 658             m/\n/ or die "$_ ?";
 659             push @{ $gitcfgs{$src}{$`} }, $'; #';
 660         }
 661         $!=0; $?=0;
 662         close GITS
 663             or ($!==0 && $?==256)
 664             or failedcmd @cmd;
 665     }
 666 }
 667
 668 sub git_get_config ($) {
 669     my ($c) = @_;
 670     foreach my $src (@gitcfgsources) {
 671         my $l = $gitcfgs{$src}{$c};
 672         confess "internal error ($l $c)" if $l && !ref $l;
 673         printdebug"C $c ".(defined $l ?
 674                            join " ", map { messagequote "'$_'" } @$l :
 675                            "undef")."\n"
 676             if $debuglevel >= 4;
 677         $l or next;
 678         @$l==1 or badcfg "multiple values for $c".
 679             " (in $src git config)" if @$l > 1;
 680         return $l->[0];
 681     }
 682     return undef;
 683 }
 684
 685 sub cfg {
 686     foreach my $c (@_) {
 687         return undef if $c =~ /RETURN-UNDEF/;
 688         printdebug "C? $c\n" if $debuglevel >= 5;
 689         my $v = git_get_config($c);
 690         return $v if defined $v;
 691         my $dv = $defcfg{$c};
 692         if (defined $dv) {
 693             printdebug "CD $c $dv\n" if $debuglevel >= 4;
 694             return $dv;
 695         }
 696     }
 697     badcfg "need value for one of: @_\n".
 698         "$us: distro or suite appears not to be (properly) supported";
 699 }
 700
 701 sub access_basedistro__noalias () {
 702     if (defined $idistro) {
 703         return $idistro;
 704     } else {
 705         my $def = cfg("dgit-suite.$isuite.distro", 'RETURN-UNDEF');
 706         return $def if defined $def;
 707         foreach my $src (@gitcfgsources, 'internal') {
 708             my $kl = $src eq 'internal' ? \%defcfg : $gitcfgs{$src};
 709             next unless $kl;
 710             foreach my $k (keys %$kl) {
 711                 next unless $k =~ m#^dgit-suite\.(.*)\.distro$#;
 712                 my $dpat = $1;
 713                 next unless match_glob $dpat, $isuite;
 714                 return $kl->{$k};
 715             }
 716         }
 717         return cfg("dgit.default.distro");
 718     }
 719 }
 720
 721 sub access_basedistro () {
 722     my $noalias = access_basedistro__noalias();
 723     my $canon = cfg("dgit-distro.$noalias.alias-canon",'RETURN-UNDEF');
 724     return $canon // $noalias;
 725 }
 726
 727 sub access_nomdistro () {
 728     my $base = access_basedistro();
 729     my $r = cfg("dgit-distro.$base.nominal-distro",'RETURN-UNDEF') // $base;
 730     $r =~ m/^$distro_re$/ or badcfg
 731  "bad syntax for (nominal) distro \`$r' (does not match /^$distro_re$/)";
 732     return $r;
 733 }
 734
 735 sub access_quirk () {
 736     # returns (quirk name, distro to use instead or undef, quirk-specific info)
 737     my $basedistro = access_basedistro();
 738     my $backports_quirk = cfg("dgit-distro.$basedistro.backports-quirk",
 739                               'RETURN-UNDEF');
 740     if (defined $backports_quirk) {
 741         my $re = $backports_quirk;
 742         $re =~ s/[^-0-9a-z_\%*()]/\\$&/ig;
 743         $re =~ s/\*/.*/g;
 744         $re =~ s/\%/([-0-9a-z_]+)/
 745             or $re =~ m/[()]/ or badcfg "backports-quirk needs \% or ( )";
 746         if ($isuite =~ m/^$re$/) {
 747             return ('backports',"$basedistro-backports",$1);
 748         }
 749     }
 750     return ('none',undef);
 751 }
 752
 753 our $access_forpush;
 754
 755 sub parse_cfg_bool ($$$) {
 756     my ($what,$def,$v) = @_;
 757     $v //= $def;
 758     return
 759         $v =~ m/^[ty1]/ ? 1 :
 760         $v =~ m/^[fn0]/ ? 0 :
 761         badcfg "$what needs t (true, y, 1) or f (false, n, 0) not \`$v'";
 762 }
 763
 764 sub access_forpush_config () {
 765     my $d = access_basedistro();
 766
 767     return 1 if
 768         $new_package &&
 769         parse_cfg_bool('new-private-pushers', 0,
 770                        cfg("dgit-distro.$d.new-private-pushers",
 771                            'RETURN-UNDEF'));
 772
 773     my $v = cfg("dgit-distro.$d.readonly", 'RETURN-UNDEF');
 774     $v //= 'a';
 775     return
 776         $v =~ m/^[ty1]/ ? 0 : # force readonly,    forpush = 0
 777         $v =~ m/^[fn0]/ ? 1 : # force nonreadonly, forpush = 1
 778         $v =~ m/^[a]/  ? '' : # auto,              forpush = ''
 779         badcfg "readonly needs t (true, y, 1) or f (false, n, 0) or a (auto)";
 780 }
 781
 782 sub access_forpush () {
 783     $access_forpush //= access_forpush_config();
 784     return $access_forpush;
 785 }
 786
 787 sub pushing () {
 788     die "$access_forpush ?" if ($access_forpush // 1) ne 1;
 789     badcfg "pushing but distro is configured readonly"
 790         if access_forpush_config() eq '0';
 791     $access_forpush = 1;
 792     $supplementary_message = <<'END' unless $we_are_responder;
 793 Push failed, before we got started.
 794 You can retry the push, after fixing the problem, if you like.
 795 END
 796     parseopts_late_defaults();
 797 }
 798
 799 sub notpushing () {
 800     parseopts_late_defaults();
 801 }
 802
 803 sub supplementary_message ($) {
 804     my ($msg) = @_;
 805     if (!$we_are_responder) {
 806         $supplementary_message = $msg;
 807         return;
 808     } elsif ($protovsn >= 3) {
 809         responder_send_command "supplementary-message ".length($msg)
 810             or die $!;
 811         print PO $msg or die $!;
 812     }
 813 }
 814
 815 sub access_distros () {
 816     # Returns list of distros to try, in order
 817     #
 818     # We want to try:
 819     #    0. `instead of' distro name(s) we have been pointed to
 820     #    1. the access_quirk distro, if any
 821     #    2a. the user's specified distro, or failing that  } basedistro
 822     #    2b. the distro calculated from the suite          }
 823     my @l = access_basedistro();
 824
 825     my (undef,$quirkdistro) = access_quirk();
 826     unshift @l, $quirkdistro;
 827     unshift @l, $instead_distro;
 828     @l = grep { defined } @l;
 829
 830     push @l, access_nomdistro();
 831
 832     if (access_forpush()) {
 833         @l = map { ("$_/push", $_) } @l;
 834     }
 835     @l;
 836 }
 837
 838 sub access_cfg_cfgs (@) {
 839     my (@keys) = @_;
 840     my @cfgs;
 841     # The nesting of these loops determines the search order.  We put
 842     # the key loop on the outside so that we search all the distros
 843     # for each key, before going on to the next key.  That means that
 844     # if access_cfg is called with a more specific, and then a less
 845     # specific, key, an earlier distro can override the less specific
 846     # without necessarily overriding any more specific keys.  (If the
 847     # distro wants to override the more specific keys it can simply do
 848     # so; whereas if we did the loop the other way around, it would be
 849     # impossible to for an earlier distro to override a less specific
 850     # key but not the more specific ones without restating the unknown
 851     # values of the more specific keys.
 852     my @realkeys;
 853     my @rundef;
 854     # We have to deal with RETURN-UNDEF specially, so that we don't
 855     # terminate the search prematurely.
 856     foreach (@keys) {
 857         if (m/RETURN-UNDEF/) { push @rundef, $_; last; }
 858         push @realkeys, $_
 859     }
 860     foreach my $d (access_distros()) {
 861         push @cfgs, map { "dgit-distro.$d.$_" } @realkeys;
 862     }
 863     push @cfgs, map { "dgit.default.$_" } @realkeys;
 864     push @cfgs, @rundef;
 865     return @cfgs;
 866 }
 867
 868 sub access_cfg (@) {
 869     my (@keys) = @_;
 870     my (@cfgs) = access_cfg_cfgs(@keys);
 871     my $value = cfg(@cfgs);
 872     return $value;
 873 }
 874
 875 sub access_cfg_bool ($$) {
 876     my ($def, @keys) = @_;
 877     parse_cfg_bool($keys[0], $def, access_cfg(@keys, 'RETURN-UNDEF'));
 878 }
 879
 880 sub string_to_ssh ($) {
 881     my ($spec) = @_;
 882     if ($spec =~ m/\s/) {
 883         return qw(sh -ec), 'exec '.$spec.' "$@"', 'x';
 884     } else {
 885         return ($spec);
 886     }
 887 }
 888
 889 sub access_cfg_ssh () {
 890     my $gitssh = access_cfg('ssh', 'RETURN-UNDEF');
 891     if (!defined $gitssh) {
 892         return @ssh;
 893     } else {
 894         return string_to_ssh $gitssh;
 895     }
 896 }
 897
 898 sub access_runeinfo ($) {
 899     my ($info) = @_;
 900     return ": dgit ".access_basedistro()." $info ;";
 901 }
 902
 903 sub access_someuserhost ($) {
 904     my ($some) = @_;
 905     my $user = access_cfg("$some-user-force", 'RETURN-UNDEF');
 906     defined($user) && length($user) or
 907         $user = access_cfg("$some-user",'username');
 908     my $host = access_cfg("$some-host");
 909     return length($user) ? "$user\@$host" : $host;
 910 }
 911
 912 sub access_gituserhost () {
 913     return access_someuserhost('git');
 914 }
 915
 916 sub access_giturl (;$) {
 917     my ($optional) = @_;
 918     my $url = access_cfg('git-url','RETURN-UNDEF');
 919     my $suffix;
 920     if (!length $url) {
 921         my $proto = access_cfg('git-proto', 'RETURN-UNDEF');
 922         return undef unless defined $proto;
 923         $url =
 924             $proto.
 925             access_gituserhost().
 926             access_cfg('git-path');
 927     } else {
 928         $suffix = access_cfg('git-url-suffix','RETURN-UNDEF');
 929     }
 930     $suffix //= '.git';
 931     return "$url/$package$suffix";
 932 }
 933
 934 sub parsecontrolfh ($$;$) {
 935     my ($fh, $desc, $allowsigned) = @_;
 936     our $dpkgcontrolhash_noissigned;
 937     my $c;
 938     for (;;) {
 939         my %opts = ('name' => $desc);
 940         $opts{allow_pgp}= $allowsigned || !$dpkgcontrolhash_noissigned;
 941         $c = Dpkg::Control::Hash->new(%opts);
 942         $c->parse($fh,$desc) or die "parsing of $desc failed";
 943         last if $allowsigned;
 944         last if $dpkgcontrolhash_noissigned;
 945         my $issigned= $c->get_option('is_pgp_signed');
 946         if (!defined $issigned) {
 947             $dpkgcontrolhash_noissigned= 1;
 948             seek $fh, 0,0 or die "seek $desc: $!";
 949         } elsif ($issigned) {
 950             fail "control file $desc is (already) PGP-signed. ".
 951                 " Note that dgit push needs to modify the .dsc and then".
 952                 " do the signature itself";
 953         } else {
 954             last;
 955         }
 956     }
 957     return $c;
 958 }
 959
 960 sub parsecontrol {
 961     my ($file, $desc, $allowsigned) = @_;
 962     my $fh = new IO::Handle;
 963     open $fh, '<', $file or die "$file: $!";
 964     my $c = parsecontrolfh($fh,$desc,$allowsigned);
 965     $fh->error and die $!;
 966     close $fh;
 967     return $c;
 968 }
 969
 970 sub getfield ($$) {
 971     my ($dctrl,$field) = @_;
 972     my $v = $dctrl->{$field};
 973     return $v if defined $v;
 974     fail "missing field $field in ".$dctrl->get_option('name');
 975 }
 976
 977 sub parsechangelog {
 978     my $c = Dpkg::Control::Hash->new(name => 'parsed changelog');
 979     my $p = new IO::Handle;
 980     my @cmd = (qw(dpkg-parsechangelog), @_);
 981     open $p, '-|', @cmd or die $!;
 982     $c->parse($p);
 983     $?=0; $!=0; close $p or failedcmd @cmd;
 984     return $c;
 985 }
 986
 987 sub commit_getclogp ($) {
 988     # Returns the parsed changelog hashref for a particular commit
 989     my ($objid) = @_;
 990     our %commit_getclogp_memo;
 991     my $memo = $commit_getclogp_memo{$objid};
 992     return $memo if $memo;
 993     mkpath '.git/dgit';
 994     my $mclog = ".git/dgit/clog-$objid";
 995     runcmd shell_cmd "exec >$mclog", @git, qw(cat-file blob),
 996         "$objid:debian/changelog";
 997     $commit_getclogp_memo{$objid} = parsechangelog("-l$mclog");
 998 }
 999
1000 sub must_getcwd () {
1001     my $d = getcwd();
1002     defined $d or fail "getcwd failed: $!";
1003     return $d;
1004 }
1005
1006 sub parse_dscdata () {
1007     my $dscfh = new IO::File \$dscdata, '<' or die $!;
1008     printdebug Dumper($dscdata) if $debuglevel>1;
1009     $dsc = parsecontrolfh($dscfh,$dscurl,1);
1010     printdebug Dumper($dsc) if $debuglevel>1;
1011 }
1012
1013 our %rmad;
1014
1015 sub archive_query ($;@) {
1016     my ($method) = shift @_;
1017     fail "this operation does not support multiple comma-separated suites"
1018         if $isuite =~ m/,/;
1019     my $query = access_cfg('archive-query','RETURN-UNDEF');
1020     $query =~ s/^(\w+):// or badcfg "invalid archive-query method \`$query'";
1021     my $proto = $1;
1022     my $data = $'; #';
1023     { no strict qw(refs); &{"${method}_${proto}"}($proto,$data,@_); }
1024 }
1025
1026 sub archive_query_prepend_mirror {
1027     my $m = access_cfg('mirror');
1028     return map { [ $_->[0], $m.$_->[1], @$_[2..$#$_] ] } @_;
1029 }
1030
1031 sub pool_dsc_subpath ($$) {
1032     my ($vsn,$component) = @_; # $package is implict arg
1033     my $prefix = substr($package, 0, $package =~ m/^l/ ? 4 : 1);
1034     return "/pool/$component/$prefix/$package/".dscfn($vsn);
1035 }
1036
1037 sub cfg_apply_map ($$$) {
1038     my ($varref, $what, $mapspec) = @_;
1039     return unless $mapspec;
1040
1041     printdebug "config $what EVAL{ $mapspec; }\n";
1042     $_ = $$varref;
1043     eval "package Dgit::Config; $mapspec;";
1044     die $@ if $@;
1045     $$varref = $_;
1046 }
1047
1048 #---------- `ftpmasterapi' archive query method (nascent) ----------
1049
1050 sub archive_api_query_cmd ($) {
1051     my ($subpath) = @_;
1052     my @cmd = (@curl, qw(-sS));
1053     my $url = access_cfg('archive-query-url');
1054     if ($url =~ m#^https://([-.0-9a-z]+)/#) {
1055         my $host = $1;
1056         my $keys = access_cfg('archive-query-tls-key','RETURN-UNDEF') //'';
1057         foreach my $key (split /\:/, $keys) {
1058             $key =~ s/\%HOST\%/$host/g;
1059             if (!stat $key) {
1060                 fail "for $url: stat $key: $!" unless $!==ENOENT;
1061                 next;
1062             }
1063             fail "config requested specific TLS key but do not know".
1064                 " how to get curl to use exactly that EE key ($key)";
1065 #           push @cmd, "--cacert", $key, "--capath", "/dev/enoent";
1066 #           # Sadly the above line does not work because of changes
1067 #           # to gnutls.   The real fix for #790093 may involve
1068 #           # new curl options.
1069             last;
1070         }
1071         # Fixing #790093 properly will involve providing a value
1072         # for this on clients.
1073         my $kargs = access_cfg('archive-query-tls-curl-ca-args','RETURN-UNDEF');
1074         push @cmd, split / /, $kargs if defined $kargs;
1075     }
1076     push @cmd, $url.$subpath;
1077     return @cmd;
1078 }
1079
1080 sub api_query ($$;$) {
1081     use JSON;
1082     my ($data, $subpath, $ok404) = @_;
1083     badcfg "ftpmasterapi archive query method takes no data part"
1084         if length $data;
1085     my @cmd = archive_api_query_cmd($subpath);
1086     my $url = $cmd[$#cmd];
1087     push @cmd, qw(-w %{http_code});
1088     my $json = cmdoutput @cmd;
1089     unless ($json =~ s/\d+\d+\d$//) {
1090         failedcmd_report_cmd undef, @cmd;
1091         fail "curl failed to print 3-digit HTTP code";
1092     }
1093     my $code = $&;
1094     return undef if $code eq '404' && $ok404;
1095     fail "fetch of $url gave HTTP code $code"
1096         unless $url =~ m#^file://# or $code =~ m/^2/;
1097     return decode_json($json);
1098 }
1099
1100 sub canonicalise_suite_ftpmasterapi {
1101     my ($proto,$data) = @_;
1102     my $suites = api_query($data, 'suites');
1103     my @matched;
1104     foreach my $entry (@$suites) {
1105         next unless grep {
1106             my $v = $entry->{$_};
1107             defined $v && $v eq $isuite;
1108         } qw(codename name);
1109         push @matched, $entry;
1110     }
1111     fail "unknown suite $isuite" unless @matched;
1112     my $cn;
1113     eval {
1114         @matched==1 or die "multiple matches for suite $isuite\n";
1115         $cn = "$matched[0]{codename}";
1116         defined $cn or die "suite $isuite info has no codename\n";
1117         $cn =~ m/^$suite_re$/ or die "suite $isuite maps to bad codename\n";
1118     };
1119     die "bad ftpmaster api response: $@\n".Dumper(\@matched)
1120         if length $@;
1121     return $cn;
1122 }
1123
1124 sub archive_query_ftpmasterapi {
1125     my ($proto,$data) = @_;
1126     my $info = api_query($data, "dsc_in_suite/$isuite/$package");
1127     my @rows;
1128     my $digester = Digest::SHA->new(256);
1129     foreach my $entry (@$info) {
1130         eval {
1131             my $vsn = "$entry->{version}";
1132             my ($ok,$msg) = version_check $vsn;
1133             die "bad version: $msg\n" unless $ok;
1134             my $component = "$entry->{component}";
1135             $component =~ m/^$component_re$/ or die "bad component";
1136             my $filename = "$entry->{filename}";
1137             $filename && $filename !~ m#[^-+:._~0-9a-zA-Z/]|^[/.]|/[/.]#
1138                 or die "bad filename";
1139             my $sha256sum = "$entry->{sha256sum}";
1140             $sha256sum =~ m/^[0-9a-f]+$/ or die "bad sha256sum";
1141             push @rows, [ $vsn, "/pool/$component/$filename",
1142                           $digester, $sha256sum ];
1143         };
1144         die "bad ftpmaster api response: $@\n".Dumper($entry)
1145             if length $@;
1146     }
1147     @rows = sort { -version_compare($a->[0],$b->[0]) } @rows;
1148     return archive_query_prepend_mirror @rows;
1149 }
1150
1151 sub file_in_archive_ftpmasterapi {
1152     my ($proto,$data,$filename) = @_;
1153     my $pat = $filename;
1154     $pat =~ s/_/\\_/g;
1155     $pat = "%/$pat";
1156     $pat =~ s#[^-+_.0-9a-z/]# sprintf '%%%02x', ord $& #ge;
1157     my $info = api_query($data, "file_in_archive/$pat", 1);
1158 }
1159
1160 #---------- `aptget' archive query method ----------
1161
1162 our $aptget_base;
1163 our $aptget_releasefile;
1164 our $aptget_configpath;
1165
1166 sub aptget_aptget   () { return @aptget,   qw(-c), $aptget_configpath; }
1167 sub aptget_aptcache () { return @aptcache, qw(-c), $aptget_configpath; }
1168
1169 sub aptget_cache_clean {
1170     runcmd_ordryrun_local qw(sh -ec),
1171         'cd "$1"; find -atime +30 -type f -print0 | xargs -0r rm --',
1172         'x', $aptget_base;
1173 }
1174
1175 sub aptget_lock_acquire () {
1176     my $lockfile = "$aptget_base/lock";
1177     open APTGET_LOCK, '>', $lockfile or die "open $lockfile: $!";
1178     flock APTGET_LOCK, LOCK_EX or die "lock $lockfile: $!";
1179 }
1180
1181 sub aptget_prep ($) {
1182     my ($data) = @_;
1183     return if defined $aptget_base;
1184
1185     badcfg "aptget archive query method takes no data part"
1186         if length $data;
1187
1188     my $cache = $ENV{XDG_CACHE_DIR} // "$ENV{HOME}/.cache";
1189
1190     ensuredir $cache;
1191     ensuredir "$cache/dgit";
1192     my $cachekey =
1193         access_cfg('aptget-cachekey','RETURN-UNDEF')
1194         // access_nomdistro();
1195
1196     $aptget_base = "$cache/dgit/aptget";
1197     ensuredir $aptget_base;
1198
1199     my $quoted_base = $aptget_base;
1200     die "$quoted_base contains bad chars, cannot continue"
1201         if $quoted_base =~ m/["\\]/; # apt.conf(5) says no escaping :-/
1202
1203     ensuredir $aptget_base;
1204
1205     aptget_lock_acquire();
1206
1207     aptget_cache_clean();
1208
1209     $aptget_configpath = "$aptget_base/apt.conf#$cachekey";
1210     my $sourceslist = "source.list#$cachekey";
1211
1212     my $aptsuites = $isuite;
1213     cfg_apply_map(\$aptsuites, 'suite map',
1214                   access_cfg('aptget-suite-map', 'RETURN-UNDEF'));
1215
1216     open SRCS, ">", "$aptget_base/$sourceslist" or die $!;
1217     printf SRCS "deb-src %s %s %s\n",
1218         access_cfg('mirror'),
1219         $aptsuites,
1220         access_cfg('aptget-components')
1221         or die $!;
1222
1223     ensuredir "$aptget_base/cache";
1224     ensuredir "$aptget_base/lists";
1225
1226     open CONF, ">", $aptget_configpath or die $!;
1227     print CONF <<END;
1228 Debug::NoLocking "true";
1229 APT::Get::List-Cleanup "false";
1230 #clear APT::Update::Post-Invoke-Success;
1231 Dir::Etc::SourceList "$quoted_base/$sourceslist";
1232 Dir::State::Lists "$quoted_base/lists";
1233 Dir::Etc::preferences "$quoted_base/preferences";
1234 Dir::Cache::srcpkgcache "$quoted_base/cache/srcs#$cachekey";
1235 Dir::Cache::pkgcache "$quoted_base/cache/pkgs#$cachekey";
1236 END
1237
1238     foreach my $key (qw(
1239                         Dir::Cache
1240                         Dir::State
1241                         Dir::Cache::Archives
1242                         Dir::Etc::SourceParts
1243                         Dir::Etc::preferencesparts
1244                       )) {
1245         ensuredir "$aptget_base/$key";
1246         print CONF "$key \"$quoted_base/$key\";\n" or die $!;
1247     };
1248
1249     my $oldatime = (time // die $!) - 1;
1250     foreach my $oldlist (<$aptget_base/lists/*Release>) {
1251         next unless stat_exists $oldlist;
1252         my ($mtime) = (stat _)[9];
1253         utime $oldatime, $mtime, $oldlist or die "$oldlist $!";
1254     }
1255
1256     runcmd_ordryrun_local aptget_aptget(), qw(update);
1257
1258     my @releasefiles;
1259     foreach my $oldlist (<$aptget_base/lists/*Release>) {
1260         next unless stat_exists $oldlist;
1261         my ($atime) = (stat _)[8];
1262         next if $atime == $oldatime;
1263         push @releasefiles, $oldlist;
1264     }
1265     my @inreleasefiles = grep { m#/InRelease$# } @releasefiles;
1266     @releasefiles = @inreleasefiles if @inreleasefiles;
1267     die "apt updated wrong number of Release files (@releasefiles), erk"
1268         unless @releasefiles == 1;
1269
1270     ($aptget_releasefile) = @releasefiles;
1271 }
1272
1273 sub canonicalise_suite_aptget {
1274     my ($proto,$data) = @_;
1275     aptget_prep($data);
1276
1277     my $release = parsecontrol $aptget_releasefile, "Release file", 1;
1278
1279     foreach my $name (qw(Codename Suite)) {
1280         my $val = $release->{$name};
1281         if (defined $val) {
1282             printdebug "release file $name: $val\n";
1283             $val =~ m/^$suite_re$/o or fail
1284  "Release file ($aptget_releasefile) specifies intolerable $name";
1285             cfg_apply_map(\$val, 'suite rmap',
1286                           access_cfg('aptget-suite-rmap', 'RETURN-UNDEF'));
1287             return $val
1288         }
1289     }
1290     return $isuite;
1291 }
1292
1293 sub archive_query_aptget {
1294     my ($proto,$data) = @_;
1295     aptget_prep($data);
1296
1297     ensuredir "$aptget_base/source";
1298     foreach my $old (<$aptget_base/source/*.dsc>) {
1299         unlink $old or die "$old: $!";
1300     }
1301
1302     my $showsrc = cmdoutput aptget_aptcache(), qw(showsrc), $package;
1303     return () unless $showsrc =~ m/^package:\s*\Q$package\E\s*$/mi;
1304     # avoids apt-get source failing with ambiguous error code
1305
1306     runcmd_ordryrun_local
1307         shell_cmd 'cd "$1"/source; shift', $aptget_base,
1308         aptget_aptget(), qw(--download-only --only-source source), $package;
1309
1310     my @dscs = <$aptget_base/source/*.dsc>;
1311     fail "apt-get source did not produce a .dsc" unless @dscs;
1312     fail "apt-get source produced several .dscs (@dscs)" unless @dscs==1;
1313
1314     my $pre_dsc = parsecontrol $dscs[0], $dscs[0], 1;
1315
1316     use URI::Escape;
1317     my $uri = "file://". uri_escape $dscs[0];
1318     $uri =~ s{\%2f}{/}gi;
1319     return [ (getfield $pre_dsc, 'Version'), $uri ];
1320 }
1321
1322 sub file_in_archive_aptget () { return undef; }
1323
1324 #---------- `dummyapicat' archive query method ----------
1325
1326 sub archive_query_dummycatapi { archive_query_ftpmasterapi @_; }
1327 sub canonicalise_suite_dummycatapi { canonicalise_suite_ftpmasterapi @_; }
1328
1329 sub file_in_archive_dummycatapi ($$$) {
1330     my ($proto,$data,$filename) = @_;
1331     my $mirror = access_cfg('mirror');
1332     $mirror =~ s#^file://#/# or die "$mirror ?";
1333     my @out;
1334     my @cmd = (qw(sh -ec), '
1335             cd "$1"
1336             find -name "$2" -print0 |
1337             xargs -0r sha256sum
1338         ', qw(x), $mirror, $filename);
1339     debugcmd "-|", @cmd;
1340     open FIA, "-|", @cmd or die $!;
1341     while (<FIA>) {
1342         chomp or die;
1343         printdebug "| $_\n";
1344         m/^(\w+)  (\S+)$/ or die "$_ ?";
1345         push @out, { sha256sum => $1, filename => $2 };
1346     }
1347     close FIA or die failedcmd @cmd;
1348     return \@out;
1349 }
1350
1351 #---------- `madison' archive query method ----------
1352
1353 sub archive_query_madison {
1354     return archive_query_prepend_mirror
1355         map { [ @$_[0..1] ] } madison_get_parse(@_);
1356 }
1357
1358 sub madison_get_parse {
1359     my ($proto,$data) = @_;
1360     die unless $proto eq 'madison';
1361     if (!length $data) {
1362         $data= access_cfg('madison-distro','RETURN-UNDEF');
1363         $data //= access_basedistro();
1364     }
1365     $rmad{$proto,$data,$package} ||= cmdoutput
1366         qw(rmadison -asource),"-s$isuite","-u$data",$package;
1367     my $rmad = $rmad{$proto,$data,$package};
1368
1369     my @out;
1370     foreach my $l (split /\n/, $rmad) {
1371         $l =~ m{^ \s*( [^ \t|]+ )\s* \|
1372                   \s*( [^ \t|]+ )\s* \|
1373                   \s*( [^ \t|/]+ )(?:/([^ \t|/]+))? \s* \|
1374                   \s*( [^ \t|]+ )\s* }x or die "$rmad ?";
1375         $1 eq $package or die "$rmad $package ?";
1376         my $vsn = $2;
1377         my $newsuite = $3;
1378         my $component;
1379         if (defined $4) {
1380             $component = $4;
1381         } else {
1382             $component = access_cfg('archive-query-default-component');
1383         }
1384         $5 eq 'source' or die "$rmad ?";
1385         push @out, [$vsn,pool_dsc_subpath($vsn,$component),$newsuite];
1386     }
1387     return sort { -version_compare($a->[0],$b->[0]); } @out;
1388 }
1389
1390 sub canonicalise_suite_madison {
1391     # madison canonicalises for us
1392     my @r = madison_get_parse(@_);
1393     @r or fail
1394         "unable to canonicalise suite using package $package".
1395         " which does not appear to exist in suite $isuite;".
1396         " --existing-package may help";
1397     return $r[0][2];
1398 }
1399
1400 sub file_in_archive_madison { return undef; }
1401
1402 #---------- `sshpsql' archive query method ----------
1403
1404 sub sshpsql ($$$) {
1405     my ($data,$runeinfo,$sql) = @_;
1406     if (!length $data) {
1407         $data= access_someuserhost('sshpsql').':'.
1408             access_cfg('sshpsql-dbname');
1409     }
1410     $data =~ m/:/ or badcfg "invalid sshpsql method string \`$data'";
1411     my ($userhost,$dbname) = ($`,$'); #';
1412     my @rows;
1413     my @cmd = (access_cfg_ssh, $userhost,
1414                access_runeinfo("ssh-psql $runeinfo").
1415                " export LC_MESSAGES=C; export LC_CTYPE=C;".
1416                " ".shellquote qw(psql -A), $dbname, qw(-c), $sql);
1417     debugcmd "|",@cmd;
1418     open P, "-|", @cmd or die $!;
1419     while (<P>) {
1420         chomp or die;
1421         printdebug(">|$_|\n");
1422         push @rows, $_;
1423     }
1424     $!=0; $?=0; close P or failedcmd @cmd;
1425     @rows or die;
1426     my $nrows = pop @rows;
1427     $nrows =~ s/^\((\d+) rows?\)$/$1/ or die "$nrows ?";
1428     @rows == $nrows+1 or die "$nrows ".(scalar @rows)." ?";
1429     @rows = map { [ split /\|/, $_ ] } @rows;
1430     my $ncols = scalar @{ shift @rows };
1431     die if grep { scalar @$_ != $ncols } @rows;
1432     return @rows;
1433 }
1434
1435 sub sql_injection_check {
1436     foreach (@_) { die "$_ $& ?" if m{[^-+=:_.,/0-9a-zA-Z]}; }
1437 }
1438
1439 sub archive_query_sshpsql ($$) {
1440     my ($proto,$data) = @_;
1441     sql_injection_check $isuite, $package;
1442     my @rows = sshpsql($data, "archive-query $isuite $package", <<END);
1443         SELECT source.version, component.name, files.filename, files.sha256sum
1444           FROM source
1445           JOIN src_associations ON source.id = src_associations.source
1446           JOIN suite ON suite.id = src_associations.suite
1447           JOIN dsc_files ON dsc_files.source = source.id
1448           JOIN files_archive_map ON files_archive_map.file_id = dsc_files.file
1449           JOIN component ON component.id = files_archive_map.component_id
1450           JOIN files ON files.id = dsc_files.file
1451          WHERE ( suite.suite_name='$isuite' OR suite.codename='$isuite' )
1452            AND source.source='$package'
1453            AND files.filename LIKE '%.dsc';
1454 END
1455     @rows = sort { -version_compare($a->[0],$b->[0]) } @rows;
1456     my $digester = Digest::SHA->new(256);
1457     @rows = map {
1458         my ($vsn,$component,$filename,$sha256sum) = @$_;
1459         [ $vsn, "/pool/$component/$filename",$digester,$sha256sum ];
1460     } @rows;
1461     return archive_query_prepend_mirror @rows;
1462 }
1463
1464 sub canonicalise_suite_sshpsql ($$) {
1465     my ($proto,$data) = @_;
1466     sql_injection_check $isuite;
1467     my @rows = sshpsql($data, "canonicalise-suite $isuite", <<END);
1468         SELECT suite.codename
1469           FROM suite where suite_name='$isuite' or codename='$isuite';
1470 END
1471     @rows = map { $_->[0] } @rows;
1472     fail "unknown suite $isuite" unless @rows;
1473     die "ambiguous $isuite: @rows ?" if @rows>1;
1474     return $rows[0];
1475 }
1476
1477 sub file_in_archive_sshpsql ($$$) { return undef; }
1478
1479 #---------- `dummycat' archive query method ----------
1480
1481 sub canonicalise_suite_dummycat ($$) {
1482     my ($proto,$data) = @_;
1483     my $dpath = "$data/suite.$isuite";
1484     if (!open C, "<", $dpath) {
1485         $!==ENOENT or die "$dpath: $!";
1486         printdebug "dummycat canonicalise_suite $isuite $dpath ENOENT\n";
1487         return $isuite;
1488     }
1489     $!=0; $_ = <C>;
1490     chomp or die "$dpath: $!";
1491     close C;
1492     printdebug "dummycat canonicalise_suite $isuite $dpath = $_\n";
1493     return $_;
1494 }
1495
1496 sub archive_query_dummycat ($$) {
1497     my ($proto,$data) = @_;
1498     canonicalise_suite();
1499     my $dpath = "$data/package.$csuite.$package";
1500     if (!open C, "<", $dpath) {
1501         $!==ENOENT or die "$dpath: $!";
1502         printdebug "dummycat query $csuite $package $dpath ENOENT\n";
1503         return ();
1504     }
1505     my @rows;
1506     while (<C>) {
1507         next if m/^\#/;
1508         next unless m/\S/;
1509         die unless chomp;
1510         printdebug "dummycat query $csuite $package $dpath | $_\n";
1511         my @row = split /\s+/, $_;
1512         @row==2 or die "$dpath: $_ ?";
1513         push @rows, \@row;
1514     }
1515     C->error and die "$dpath: $!";
1516     close C;
1517     return archive_query_prepend_mirror
1518         sort { -version_compare($a->[0],$b->[0]); } @rows;
1519 }
1520
1521 sub file_in_archive_dummycat () { return undef; }
1522
1523 #---------- tag format handling ----------
1524
1525 sub access_cfg_tagformats () {
1526     split /\,/, access_cfg('dgit-tag-format');
1527 }
1528
1529 sub access_cfg_tagformats_can_splitbrain () {
1530     my %y = map { $_ => 1 } access_cfg_tagformats;
1531     foreach my $needtf (qw(new maint)) {
1532         next if $y{$needtf};
1533         return 0;
1534     }
1535     return 1;
1536 }
1537
1538 sub need_tagformat ($$) {
1539     my ($fmt, $why) = @_;
1540     fail "need to use tag format $fmt ($why) but also need".
1541         " to use tag format $tagformat_want->[0] ($tagformat_want->[1])".
1542         " - no way to proceed"
1543         if $tagformat_want && $tagformat_want->[0] ne $fmt;
1544     $tagformat_want = [$fmt, $why, $tagformat_want->[2] // 0];
1545 }
1546
1547 sub select_tagformat () {
1548     # sets $tagformatfn
1549     return if $tagformatfn && !$tagformat_want;
1550     die 'bug' if $tagformatfn && $tagformat_want;
1551     # ... $tagformat_want assigned after previous select_tagformat
1552
1553     my (@supported) = grep { $_ =~ m/^(?:old|new)$/ } access_cfg_tagformats();
1554     printdebug "select_tagformat supported @supported\n";
1555
1556     $tagformat_want //= [ $supported[0], "distro access configuration", 0 ];
1557     printdebug "select_tagformat specified @$tagformat_want\n";
1558
1559     my ($fmt,$why,$override) = @$tagformat_want;
1560
1561     fail "target distro supports tag formats @supported".
1562         " but have to use $fmt ($why)"
1563         unless $override
1564             or grep { $_ eq $fmt } @supported;
1565
1566     $tagformat_want = undef;
1567     $tagformat = $fmt;
1568     $tagformatfn = ${*::}{"debiantag_$fmt"};
1569
1570     fail "trying to use unknown tag format \`$fmt' ($why) !"
1571         unless $tagformatfn;
1572 }
1573
1574 #---------- archive query entrypoints and rest of program ----------
1575
1576 sub canonicalise_suite () {
1577     return if defined $csuite;
1578     fail "cannot operate on $isuite suite" if $isuite eq 'UNRELEASED';
1579     $csuite = archive_query('canonicalise_suite');
1580     if ($isuite ne $csuite) {
1581         progress "canonical suite name for $isuite is $csuite";
1582     } else {
1583         progress "canonical suite name is $csuite";
1584     }
1585 }
1586
1587 sub get_archive_dsc () {
1588     canonicalise_suite();
1589     my @vsns = archive_query('archive_query');
1590     foreach my $vinfo (@vsns) {
1591         my ($vsn,$vsn_dscurl,$digester,$digest) = @$vinfo;
1592         $dscurl = $vsn_dscurl;
1593         $dscdata = url_get($dscurl);
1594         if (!$dscdata) {
1595             $skew_warning_vsn = $vsn if !defined $skew_warning_vsn;
1596             next;
1597         }
1598         if ($digester) {
1599             $digester->reset();
1600             $digester->add($dscdata);
1601             my $got = $digester->hexdigest();
1602             $got eq $digest or
1603                 fail "$dscurl has hash $got but".
1604                     " archive told us to expect $digest";
1605         }
1606         parse_dscdata();
1607         my $fmt = getfield $dsc, 'Format';
1608         $format_ok{$fmt} or forceable_fail [qw(unsupported-source-format)],
1609             "unsupported source format $fmt, sorry";
1610
1611         $dsc_checked = !!$digester;
1612         printdebug "get_archive_dsc: Version ".(getfield $dsc, 'Version')."\n";
1613         return;
1614     }
1615     $dsc = undef;
1616     printdebug "get_archive_dsc: nothing in archive, returning undef\n";
1617 }
1618
1619 sub check_for_git ();
1620 sub check_for_git () {
1621     # returns 0 or 1
1622     my $how = access_cfg('git-check');
1623     if ($how eq 'ssh-cmd') {
1624         my @cmd =
1625             (access_cfg_ssh, access_gituserhost(),
1626              access_runeinfo("git-check $package").
1627              " set -e; cd ".access_cfg('git-path').";".
1628              " if test -d $package.git; then echo 1; else echo 0; fi");
1629         my $r= cmdoutput @cmd;
1630         if (defined $r and $r =~ m/^divert (\w+)$/) {
1631             my $divert=$1;
1632             my ($usedistro,) = access_distros();
1633             # NB that if we are pushing, $usedistro will be $distro/push
1634             $instead_distro= cfg("dgit-distro.$usedistro.diverts.$divert");
1635             $instead_distro =~ s{^/}{ access_basedistro()."/" }e;
1636             progress "diverting to $divert (using config for $instead_distro)";
1637             return check_for_git();
1638         }
1639         failedcmd @cmd unless defined $r and $r =~ m/^[01]$/;
1640         return $r+0;
1641     } elsif ($how eq 'url') {
1642         my $prefix = access_cfg('git-check-url','git-url');
1643         my $suffix = access_cfg('git-check-suffix','git-suffix',
1644                                 'RETURN-UNDEF') // '.git';
1645         my $url = "$prefix/$package$suffix";
1646         my @cmd = (@curl, qw(-sS -I), $url);
1647         my $result = cmdoutput @cmd;
1648         $result =~ s/^\S+ 200 .*\n\r?\n//;
1649         # curl -sS -I with https_proxy prints
1650         # HTTP/1.0 200 Connection established
1651         $result =~ m/^\S+ (404|200) /s or
1652             fail "unexpected results from git check query - ".
1653                 Dumper($prefix, $result);
1654         my $code = $1;
1655         if ($code eq '404') {
1656             return 0;
1657         } elsif ($code eq '200') {
1658             return 1;
1659         } else {
1660             die;
1661         }
1662     } elsif ($how eq 'true') {
1663         return 1;
1664     } elsif ($how eq 'false') {
1665         return 0;
1666     } else {
1667         badcfg "unknown git-check \`$how'";
1668     }
1669 }
1670
1671 sub create_remote_git_repo () {
1672     my $how = access_cfg('git-create');
1673     if ($how eq 'ssh-cmd') {
1674         runcmd_ordryrun
1675             (access_cfg_ssh, access_gituserhost(),
1676              access_runeinfo("git-create $package").
1677              "set -e; cd ".access_cfg('git-path').";".
1678              " cp -a _template $package.git");
1679     } elsif ($how eq 'true') {
1680         # nothing to do
1681     } else {
1682         badcfg "unknown git-create \`$how'";
1683     }
1684 }
1685
1686 our ($dsc_hash,$lastpush_mergeinput);
1687 our ($dsc_distro, $dsc_hint_tag, $dsc_hint_url);
1688
1689 our $ud = '.git/dgit/unpack';
1690
1691 sub prep_ud (;$) {
1692     my ($d) = @_;
1693     $d //= $ud;
1694     rmtree($d);
1695     mkpath '.git/dgit';
1696     mkdir $d or die $!;
1697 }
1698
1699 sub mktree_in_ud_here () {
1700     runcmd qw(git init -q);
1701     runcmd qw(git config gc.auto 0);
1702     foreach my $copy (qw(user.email user.name user.useConfigOnly)) {
1703         my $v = $gitcfgs{local}{$copy};
1704         next unless $v;
1705         runcmd qw(git config), $copy, $_ foreach @$v;
1706     }
1707     rmtree('.git/objects');
1708     symlink '../../../../objects','.git/objects' or die $!;
1709     setup_gitattrs(1);
1710 }
1711
1712 sub git_write_tree () {
1713     my $tree = cmdoutput @git, qw(write-tree);
1714     $tree =~ m/^\w+$/ or die "$tree ?";
1715     return $tree;
1716 }
1717
1718 sub git_add_write_tree () {
1719     runcmd @git, qw(add -Af .);
1720     return git_write_tree();
1721 }
1722
1723 sub remove_stray_gits ($) {
1724     my ($what) = @_;
1725     my @gitscmd = qw(find -name .git -prune -print0);
1726     debugcmd "|",@gitscmd;
1727     open GITS, "-|", @gitscmd or die $!;
1728     {
1729         local $/="\0";
1730         while (<GITS>) {
1731             chomp or die;
1732             print STDERR "$us: warning: removing from $what: ",
1733                 (messagequote $_), "\n";
1734             rmtree $_;
1735         }
1736     }
1737     $!=0; $?=0; close GITS or failedcmd @gitscmd;
1738 }
1739
1740 sub mktree_in_ud_from_only_subdir ($;$) {
1741     my ($what,$raw) = @_;
1742
1743     # changes into the subdir
1744     my (@dirs) = <*/.>;
1745     die "expected one subdir but found @dirs ?" unless @dirs==1;
1746     $dirs[0] =~ m#^([^/]+)/\.$# or die;
1747     my $dir = $1;
1748     changedir $dir;
1749
1750     remove_stray_gits($what);
1751     mktree_in_ud_here();
1752     if (!$raw) {
1753         my ($format, $fopts) = get_source_format();
1754         if (madformat($format)) {
1755             rmtree '.pc';
1756         }
1757     }
1758
1759     my $tree=git_add_write_tree();
1760     return ($tree,$dir);
1761 }
1762
1763 our @files_csum_info_fields =
1764     (['Checksums-Sha256','Digest::SHA', 'new(256)', 'sha256sum'],
1765      ['Checksums-Sha1',  'Digest::SHA', 'new(1)',   'sha1sum'],
1766      ['Files',           'Digest::MD5', 'new()',    'md5sum']);
1767
1768 sub dsc_files_info () {
1769     foreach my $csumi (@files_csum_info_fields) {
1770         my ($fname, $module, $method) = @$csumi;
1771         my $field = $dsc->{$fname};
1772         next unless defined $field;
1773         eval "use $module; 1;" or die $@;
1774         my @out;
1775         foreach (split /\n/, $field) {
1776             next unless m/\S/;
1777             m/^(\w+) (\d+) (\S+)$/ or
1778                 fail "could not parse .dsc $fname line \`$_'";
1779             my $digester = eval "$module"."->$method;" or die $@;
1780             push @out, {
1781                 Hash => $1,
1782                 Bytes => $2,
1783                 Filename => $3,
1784                 Digester => $digester,
1785             };
1786         }
1787         return @out;
1788     }
1789     fail "missing any supported Checksums-* or Files field in ".
1790         $dsc->get_option('name');
1791 }
1792
1793 sub dsc_files () {
1794     map { $_->{Filename} } dsc_files_info();
1795 }
1796
1797 sub files_compare_inputs (@) {
1798     my $inputs = \@_;
1799     my %record;
1800     my %fchecked;
1801
1802     my $showinputs = sub {
1803         return join "; ", map { $_->get_option('name') } @$inputs;
1804     };
1805
1806     foreach my $in (@$inputs) {
1807         my $expected_files;
1808         my $in_name = $in->get_option('name');
1809
1810         printdebug "files_compare_inputs $in_name\n";
1811
1812         foreach my $csumi (@files_csum_info_fields) {
1813             my ($fname) = @$csumi;
1814             printdebug "files_compare_inputs $in_name $fname\n";
1815
1816             my $field = $in->{$fname};
1817             next unless defined $field;
1818
1819             my @files;
1820             foreach (split /\n/, $field) {
1821                 next unless m/\S/;
1822
1823                 my ($info, $f) = m/^(\w+ \d+) (?:\S+ \S+ )?(\S+)$/ or
1824                     fail "could not parse $in_name $fname line \`$_'";
1825
1826                 printdebug "files_compare_inputs $in_name $fname $f\n";
1827
1828                 push @files, $f;
1829
1830                 my $re = \ $record{$f}{$fname};
1831                 if (defined $$re) {
1832                     $fchecked{$f}{$in_name} = 1;
1833                     $$re eq $info or
1834                         fail "hash or size of $f varies in $fname fields".
1835                         " (between: ".$showinputs->().")";
1836                 } else {
1837                     $$re = $info;
1838                 }
1839             }
1840             @files = sort @files;
1841             $expected_files //= \@files;
1842             "@$expected_files" eq "@files" or
1843                 fail "file list in $in_name varies between hash fields!";
1844         }
1845         $expected_files or
1846             fail "$in_name has no files list field(s)";
1847     }
1848     printdebug "files_compare_inputs ".Dumper(\%fchecked, \%record)
1849         if $debuglevel>=2;
1850
1851     grep { keys %$_ == @$inputs-1 } values %fchecked
1852         or fail "no file appears in all file lists".
1853         " (looked in: ".$showinputs->().")";
1854 }
1855
1856 sub is_orig_file_in_dsc ($$) {
1857     my ($f, $dsc_files_info) = @_;
1858     return 0 if @$dsc_files_info <= 1;
1859     # One file means no origs, and the filename doesn't have a "what
1860     # part of dsc" component.  (Consider versions ending `.orig'.)
1861     return 0 unless $f =~ m/\.$orig_f_tail_re$/o;
1862     return 1;
1863 }
1864
1865 sub is_orig_file_of_vsn ($$) {
1866     my ($f, $upstreamvsn) = @_;
1867     my $base = srcfn $upstreamvsn, '';
1868     return 0 unless $f =~ m/^\Q$base\E\.$orig_f_tail_re$/;
1869     return 1;
1870 }
1871
1872 sub changes_update_origs_from_dsc ($$$$) {
1873     my ($dsc, $changes, $upstreamvsn, $changesfile) = @_;
1874     my %changes_f;
1875     printdebug "checking origs needed ($upstreamvsn)...\n";
1876     $_ = getfield $changes, 'Files';
1877     m/^\w+ \d+ (\S+ \S+) \S+$/m or
1878         fail "cannot find section/priority from .changes Files field";
1879     my $placementinfo = $1;
1880     my %changed;
1881     printdebug "checking origs needed placement '$placementinfo'...\n";
1882     foreach my $l (split /\n/, getfield $dsc, 'Files') {
1883         $l =~ m/\S+$/ or next;
1884         my $file = $&;
1885         printdebug "origs $file | $l\n";
1886         next unless is_orig_file_of_vsn $file, $upstreamvsn;
1887         printdebug "origs $file is_orig\n";
1888         my $have = archive_query('file_in_archive', $file);
1889         if (!defined $have) {
1890             print STDERR <<END;
1891 archive does not support .orig check; hope you used --ch:--sa/-sd if needed
1892 END
1893             return;
1894         }
1895         my $found_same = 0;
1896         my @found_differ;
1897         printdebug "origs $file \$#\$have=$#$have\n";
1898         foreach my $h (@$have) {
1899             my $same = 0;
1900             my @differ;
1901             foreach my $csumi (@files_csum_info_fields) {
1902                 my ($fname, $module, $method, $archivefield) = @$csumi;
1903                 next unless defined $h->{$archivefield};
1904                 $_ = $dsc->{$fname};
1905                 next unless defined;
1906                 m/^(\w+) .* \Q$file\E$/m or
1907                     fail ".dsc $fname missing entry for $file";
1908                 if ($h->{$archivefield} eq $1) {
1909                     $same++;
1910                 } else {
1911                     push @differ,
1912  "$archivefield: $h->{$archivefield} (archive) != $1 (local .dsc)";
1913                 }
1914             }
1915             die "$file ".Dumper($h)." ?!" if $same && @differ;
1916             $found_same++
1917                 if $same;
1918             push @found_differ, "archive $h->{filename}: ".join "; ", @differ
1919                 if @differ;
1920         }
1921         printdebug "origs $file f.same=$found_same".
1922             " #f._differ=$#found_differ\n";
1923         if (@found_differ && !$found_same) {
1924             fail join "\n",
1925                 "archive contains $file with different checksum",
1926                 @found_differ;
1927         }
1928         # Now we edit the changes file to add or remove it
1929         foreach my $csumi (@files_csum_info_fields) {
1930             my ($fname, $module, $method, $archivefield) = @$csumi;
1931             next unless defined $changes->{$fname};
1932             if ($found_same) {
1933                 # in archive, delete from .changes if it's there
1934                 $changed{$file} = "removed" if
1935                     $changes->{$fname} =~ s/^.* \Q$file\E$(?:)\n//m;
1936             } elsif ($changes->{$fname} =~ m/^.* \Q$file\E$(?:)\n/m) {
1937                 # not in archive, but it's here in the .changes
1938             } else {
1939                 my $dsc_data = getfield $dsc, $fname;
1940                 $dsc_data =~ m/^(.* \Q$file\E$)\n/m or die "$dsc_data $file ?";
1941                 my $extra = $1;
1942                 $extra =~ s/ \d+ /$&$placementinfo /
1943                     or die "$fname $extra >$dsc_data< ?"
1944                     if $fname eq 'Files';
1945                 $changes->{$fname} .= "\n". $extra;
1946                 $changed{$file} = "added";
1947             }
1948         }
1949     }
1950     if (%changed) {
1951         foreach my $file (keys %changed) {
1952             progress sprintf
1953                 "edited .changes for archive .orig contents: %s %s",
1954                 $changed{$file}, $file;
1955         }
1956         my $chtmp = "$changesfile.tmp";
1957         $changes->save($chtmp);
1958         if (act_local()) {
1959             rename $chtmp,$changesfile or die "$changesfile $!";
1960         } else {
1961             progress "[new .changes left in $changesfile]";
1962         }
1963     } else {
1964         progress "$changesfile already has appropriate .orig(s) (if any)";
1965     }
1966 }
1967
1968 sub make_commit ($) {
1969     my ($file) = @_;
1970     return cmdoutput @git, qw(hash-object -w -t commit), $file;
1971 }
1972
1973 sub make_commit_text ($) {
1974     my ($text) = @_;
1975     my ($out, $in);
1976     my @cmd = (@git, qw(hash-object -w -t commit --stdin));
1977     debugcmd "|",@cmd;
1978     print Dumper($text) if $debuglevel > 1;
1979     my $child = open2($out, $in, @cmd) or die $!;
1980     my $h;
1981     eval {
1982         print $in $text or die $!;
1983         close $in or die $!;
1984         $h = <$out>;
1985         $h =~ m/^\w+$/ or die;
1986         $h = $&;
1987         printdebug "=> $h\n";
1988     };
1989     close $out;
1990     waitpid $child, 0 == $child or die "$child $!";
1991     $? and failedcmd @cmd;
1992     return $h;
1993 }
1994
1995 sub clogp_authline ($) {
1996     my ($clogp) = @_;
1997     my $author = getfield $clogp, 'Maintainer';
1998     $author =~ s#,.*##ms;
1999     my $date = cmdoutput qw(date), '+%s %z', qw(-d), getfield($clogp,'Date');
2000     my $authline = "$author $date";
2001     $authline =~ m/$git_authline_re/o or
2002         fail "unexpected commit author line format \`$authline'".
2003         " (was generated from changelog Maintainer field)";
2004     return ($1,$2,$3) if wantarray;
2005     return $authline;
2006 }
2007
2008 sub vendor_patches_distro ($$) {
2009     my ($checkdistro, $what) = @_;
2010     return unless defined $checkdistro;
2011
2012     my $series = "debian/patches/\L$checkdistro\E.series";
2013     printdebug "checking for vendor-specific $series ($what)\n";
2014
2015     if (!open SERIES, "<", $series) {
2016         die "$series $!" unless $!==ENOENT;
2017         return;
2018     }
2019     while (<SERIES>) {
2020         next unless m/\S/;
2021         next if m/^\s+\#/;
2022
2023         print STDERR <<END;
2024
2025 Unfortunately, this source package uses a feature of dpkg-source where
2026 the same source package unpacks to different source code on different
2027 distros.  dgit cannot safely operate on such packages on affected
2028 distros, because the meaning of source packages is not stable.
2029
2030 Please ask the distro/maintainer to remove the distro-specific series
2031 files and use a different technique (if necessary, uploading actually
2032 different packages, if different distros are supposed to have
2033 different code).
2034
2035 END
2036         fail "Found active distro-specific series file for".
2037             " $checkdistro ($what): $series, cannot continue";
2038     }
2039     die "$series $!" if SERIES->error;
2040     close SERIES;
2041 }
2042
2043 sub check_for_vendor_patches () {
2044     # This dpkg-source feature doesn't seem to be documented anywhere!
2045     # But it can be found in the changelog (reformatted):
2046
2047     #   commit  4fa01b70df1dc4458daee306cfa1f987b69da58c
2048     #   Author: Raphael Hertzog <hertzog@debian.org>
2049     #   Date: Sun  Oct  3  09:36:48  2010 +0200
2050
2051     #   dpkg-source: correctly create .pc/.quilt_series with alternate
2052     #   series files
2053     #
2054     #   If you have debian/patches/ubuntu.series and you were
2055     #   unpacking the source package on ubuntu, quilt was still
2056     #   directed to debian/patches/series instead of
2057     #   debian/patches/ubuntu.series.
2058     #
2059     #   debian/changelog                        |    3 +++
2060     #   scripts/Dpkg/Source/Package/V3/quilt.pm |    4 +++-
2061     #   2 files changed, 6 insertions(+), 1 deletion(-)
2062
2063     use Dpkg::Vendor;
2064     vendor_patches_distro($ENV{DEB_VENDOR}, "DEB_VENDOR");
2065     vendor_patches_distro(Dpkg::Vendor::get_current_vendor(),
2066                          "Dpkg::Vendor \`current vendor'");
2067     vendor_patches_distro(access_basedistro(),
2068                           "(base) distro being accessed");
2069     vendor_patches_distro(access_nomdistro(),
2070                           "(nominal) distro being accessed");
2071 }
2072
2073 sub generate_commits_from_dsc () {
2074     # See big comment in fetch_from_archive, below.
2075     # See also README.dsc-import.
2076     prep_ud();
2077     changedir $ud;
2078
2079     my @dfi = dsc_files_info();
2080     foreach my $fi (@dfi) {
2081         my $f = $fi->{Filename};
2082         die "$f ?" if $f =~ m#/|^\.|\.dsc$|\.tmp$#;
2083         my $upper_f = "../../../../$f";
2084
2085         printdebug "considering reusing $f: ";
2086
2087         if (link_ltarget "$upper_f,fetch", $f) {
2088             printdebug "linked (using ...,fetch).\n";
2089         } elsif ((printdebug "($!) "),
2090                  $! != ENOENT) {
2091             fail "accessing ../$f,fetch: $!";
2092         } elsif (link_ltarget $upper_f, $f) {
2093             printdebug "linked.\n";
2094         } elsif ((printdebug "($!) "),
2095                  $! != ENOENT) {
2096             fail "accessing ../$f: $!";
2097         } else {
2098             printdebug "absent.\n";
2099         }
2100
2101         my $refetched;
2102         complete_file_from_dsc('.', $fi, \$refetched)
2103             or next;
2104
2105         printdebug "considering saving $f: ";
2106
2107         if (link $f, $upper_f) {
2108             printdebug "linked.\n";
2109         } elsif ((printdebug "($!) "),
2110                  $! != EEXIST) {
2111             fail "saving ../$f: $!";
2112         } elsif (!$refetched) {
2113             printdebug "no need.\n";
2114         } elsif (link $f, "$upper_f,fetch") {
2115             printdebug "linked (using ...,fetch).\n";
2116         } elsif ((printdebug "($!) "),
2117                  $! != EEXIST) {
2118             fail "saving ../$f,fetch: $!";
2119         } else {
2120             printdebug "cannot.\n";
2121         }
2122     }
2123
2124     # We unpack and record the orig tarballs first, so that we only
2125     # need disk space for one private copy of the unpacked source.
2126     # But we can't make them into commits until we have the metadata
2127     # from the debian/changelog, so we record the tree objects now and
2128     # make them into commits later.
2129     my @tartrees;
2130     my $upstreamv = upstreamversion $dsc->{version};
2131     my $orig_f_base = srcfn $upstreamv, '';
2132
2133     foreach my $fi (@dfi) {
2134         # We actually import, and record as a commit, every tarball
2135         # (unless there is only one file, in which case there seems
2136         # little point.
2137
2138         my $f = $fi->{Filename};
2139         printdebug "import considering $f ";
2140         (printdebug "only one dfi\n"), next if @dfi == 1;
2141         (printdebug "not tar\n"), next unless $f =~ m/\.tar(\.\w+)?$/;
2142         (printdebug "signature\n"), next if $f =~ m/$orig_f_sig_re$/o;
2143         my $compr_ext = $1;
2144
2145         my ($orig_f_part) =
2146             $f =~ m/^\Q$orig_f_base\E\.([^._]+)?\.tar(?:\.\w+)?$/;
2147
2148         printdebug "Y ", (join ' ', map { $_//"(none)" }
2149                           $compr_ext, $orig_f_part
2150                          ), "\n";
2151
2152         my $input = new IO::File $f, '<' or die "$f $!";
2153         my $compr_pid;
2154         my @compr_cmd;
2155
2156         if (defined $compr_ext) {
2157             my $cname =
2158                 Dpkg::Compression::compression_guess_from_filename $f;
2159             fail "Dpkg::Compression cannot handle file $f in source package"
2160                 if defined $compr_ext && !defined $cname;
2161             my $compr_proc =
2162                 new Dpkg::Compression::Process compression => $cname;
2163             my @compr_cmd = $compr_proc->get_uncompress_cmdline();
2164             my $compr_fh = new IO::Handle;
2165             my $compr_pid = open $compr_fh, "-|" // die $!;
2166             if (!$compr_pid) {
2167                 open STDIN, "<&", $input or die $!;
2168                 exec @compr_cmd;
2169                 die "dgit (child): exec $compr_cmd[0]: $!\n";
2170             }
2171             $input = $compr_fh;
2172         }
2173
2174         rmtree "_unpack-tar";
2175         mkdir "_unpack-tar" or die $!;
2176         my @tarcmd = qw(tar -x -f -
2177                         --no-same-owner --no-same-permissions
2178                         --no-acls --no-xattrs --no-selinux);
2179         my $tar_pid = fork // die $!;
2180         if (!$tar_pid) {
2181             chdir "_unpack-tar" or die $!;
2182             open STDIN, "<&", $input or die $!;
2183             exec @tarcmd;
2184             die "dgit (child): exec $tarcmd[0]: $!";
2185         }
2186         $!=0; (waitpid $tar_pid, 0) == $tar_pid or die $!;
2187         !$? or failedcmd @tarcmd;
2188
2189         close $input or
2190             (@compr_cmd ? failedcmd @compr_cmd
2191              : die $!);
2192         # finally, we have the results in "tarball", but maybe
2193         # with the wrong permissions
2194
2195         runcmd qw(chmod -R +rwX _unpack-tar);
2196         changedir "_unpack-tar";
2197         remove_stray_gits($f);
2198         mktree_in_ud_here();
2199
2200         my ($tree) = git_add_write_tree();
2201         my $tentries = cmdoutput @git, qw(ls-tree -z), $tree;
2202         if ($tentries =~ m/^\d+ tree (\w+)\t[^\000]+\000$/s) {
2203             $tree = $1;
2204             printdebug "one subtree $1\n";
2205         } else {
2206             printdebug "multiple subtrees\n";
2207         }
2208         changedir "..";
2209         rmtree "_unpack-tar";
2210
2211         my $ent = [ $f, $tree ];
2212         push @tartrees, {
2213             Orig => !!$orig_f_part,
2214             Sort => (!$orig_f_part         ? 2 :
2215                      $orig_f_part =~ m/-/g ? 1 :
2216                                              0),
2217             F => $f,
2218             Tree => $tree,
2219         };
2220     }
2221
2222     @tartrees = sort {
2223         # put any without "_" first (spec is not clear whether files
2224         # are always in the usual order).  Tarballs without "_" are
2225         # the main orig or the debian tarball.
2226         $a->{Sort} <=> $b->{Sort} or
2227         $a->{F}    cmp $b->{F}
2228     } @tartrees;
2229
2230     my $any_orig = grep { $_->{Orig} } @tartrees;
2231
2232     my $dscfn = "$package.dsc";
2233
2234     my $treeimporthow = 'package';
2235
2236     open D, ">", $dscfn or die "$dscfn: $!";
2237     print D $dscdata or die "$dscfn: $!";
2238     close D or die "$dscfn: $!";
2239     my @cmd = qw(dpkg-source);
2240     push @cmd, '--no-check' if $dsc_checked;
2241     if (madformat $dsc->{format}) {
2242         push @cmd, '--skip-patches';
2243         $treeimporthow = 'unpatched';
2244     }
2245     push @cmd, qw(-x --), $dscfn;
2246     runcmd @cmd;
2247
2248     my ($tree,$dir) = mktree_in_ud_from_only_subdir("source package");
2249     if (madformat $dsc->{format}) {
2250         check_for_vendor_patches();
2251     }
2252
2253     my $dappliedtree;
2254     if (madformat $dsc->{format}) {
2255         my @pcmd = qw(dpkg-source --before-build .);
2256         runcmd shell_cmd 'exec >/dev/null', @pcmd;
2257         rmtree '.pc';
2258         $dappliedtree = git_add_write_tree();
2259     }
2260
2261     my @clogcmd = qw(dpkg-parsechangelog --format rfc822 --all);
2262     debugcmd "|",@clogcmd;
2263     open CLOGS, "-|", @clogcmd or die $!;
2264
2265     my $clogp;
2266     my $r1clogp;
2267
2268     printdebug "import clog search...\n";
2269
2270     for (;;) {
2271         my $stanzatext = do { local $/=""; <CLOGS>; };
2272         printdebug "import clogp ".Dumper($stanzatext) if $debuglevel>1;
2273         last if !defined $stanzatext;
2274
2275         my $desc = "package changelog, entry no.$.";
2276         open my $stanzafh, "<", \$stanzatext or die;
2277         my $thisstanza = parsecontrolfh $stanzafh, $desc, 1;
2278         $clogp //= $thisstanza;
2279
2280         printdebug "import clog $thisstanza->{version} $desc...\n";
2281
2282         last if !$any_orig; # we don't need $r1clogp
2283
2284         # We look for the first (most recent) changelog entry whose
2285         # version number is lower than the upstream version of this
2286         # package.  Then the last (least recent) previous changelog
2287         # entry is treated as the one which introduced this upstream
2288         # version and used for the synthetic commits for the upstream
2289         # tarballs.
2290
2291         # One might think that a more sophisticated algorithm would be
2292         # necessary.  But: we do not want to scan the whole changelog
2293         # file.  Stopping when we see an earlier version, which
2294         # necessarily then is an earlier upstream version, is the only
2295         # realistic way to do that.  Then, either the earliest
2296         # changelog entry we have seen so far is indeed the earliest
2297         # upload of this upstream version; or there are only changelog
2298         # entries relating to later upstream versions (which is not
2299         # possible unless the changelog and .dsc disagree about the
2300         # version).  Then it remains to choose between the physically
2301         # last entry in the file, and the one with the lowest version
2302         # number.  If these are not the same, we guess that the
2303         # versions were created in a non-monotic order rather than
2304         # that the changelog entries have been misordered.
2305
2306         printdebug "import clog $thisstanza->{version} vs $upstreamv...\n";
2307
2308         last if version_compare($thisstanza->{version}, $upstreamv) < 0;
2309         $r1clogp = $thisstanza;
2310
2311         printdebug "import clog $r1clogp->{version} becomes r1\n";
2312     }
2313     die $! if CLOGS->error;
2314     close CLOGS or $?==SIGPIPE or failedcmd @clogcmd;
2315
2316     $clogp or fail "package changelog has no entries!";
2317
2318     my $authline = clogp_authline $clogp;
2319     my $changes = getfield $clogp, 'Changes';
2320     $changes =~ s/^\n//; # Changes: \n
2321     my $cversion = getfield $clogp, 'Version';
2322
2323     if (@tartrees) {
2324         $r1clogp //= $clogp; # maybe there's only one entry;
2325         my $r1authline = clogp_authline $r1clogp;
2326         # Strictly, r1authline might now be wrong if it's going to be
2327         # unused because !$any_orig.  Whatever.
2328
2329         printdebug "import tartrees authline   $authline\n";
2330         printdebug "import tartrees r1authline $r1authline\n";
2331
2332         foreach my $tt (@tartrees) {
2333             printdebug "import tartree $tt->{F} $tt->{Tree}\n";
2334
2335             $tt->{Commit} = make_commit_text($tt->{Orig} ? <<END_O : <<END_T);
2336 tree $tt->{Tree}
2337 author $r1authline
2338 committer $r1authline
2339
2340 Import $tt->{F}
2341
2342 [dgit import orig $tt->{F}]
2343 END_O
2344 tree $tt->{Tree}
2345 author $authline
2346 committer $authline
2347
2348 Import $tt->{F}
2349
2350 [dgit import tarball $package $cversion $tt->{F}]
2351 END_T
2352         }
2353     }
2354
2355     printdebug "import main commit\n";
2356
2357     open C, ">../commit.tmp" or die $!;
2358     print C <<END or die $!;
2359 tree $tree
2360 END
2361     print C <<END or die $! foreach @tartrees;
2362 parent $_->{Commit}
2363 END
2364     print C <<END or die $!;
2365 author $authline
2366 committer $authline
2367
2368 $changes
2369
2370 [dgit import $treeimporthow $package $cversion]
2371 END
2372
2373     close C or die $!;
2374     my $rawimport_hash = make_commit qw(../commit.tmp);
2375
2376     if (madformat $dsc->{format}) {
2377         printdebug "import apply patches...\n";
2378
2379         # regularise the state of the working tree so that
2380         # the checkout of $rawimport_hash works nicely.
2381         my $dappliedcommit = make_commit_text(<<END);
2382 tree $dappliedtree
2383 author $authline
2384 committer $authline
2385
2386 [dgit dummy commit]
2387 END
2388         runcmd @git, qw(checkout -q -b dapplied), $dappliedcommit;
2389
2390         runcmd @git, qw(checkout -q -b unpa), $rawimport_hash;
2391
2392         # We need the answers to be reproducible
2393         my @authline = clogp_authline($clogp);
2394         local $ENV{GIT_COMMITTER_NAME} =  $authline[0];
2395         local $ENV{GIT_COMMITTER_EMAIL} = $authline[1];
2396         local $ENV{GIT_COMMITTER_DATE} =  $authline[2];
2397         local $ENV{GIT_AUTHOR_NAME} =  $authline[0];
2398         local $ENV{GIT_AUTHOR_EMAIL} = $authline[1];
2399         local $ENV{GIT_AUTHOR_DATE} =  $authline[2];
2400
2401         my $path = $ENV{PATH} or die;
2402
2403         foreach my $use_absurd (qw(0 1)) {
2404             runcmd @git, qw(checkout -q unpa);
2405             runcmd @git, qw(update-ref -d refs/heads/patch-queue/unpa);
2406             local $ENV{PATH} = $path;
2407             if ($use_absurd) {
2408                 chomp $@;
2409                 progress "warning: $@";
2410                 $path = "$absurdity:$path";
2411                 progress "$us: trying slow absurd-git-apply...";
2412                 rename "../../gbp-pq-output","../../gbp-pq-output.0"
2413                     or $!==ENOENT
2414                     or die $!;
2415             }
2416             eval {
2417                 die "forbid absurd git-apply\n" if $use_absurd
2418                     && forceing [qw(import-gitapply-no-absurd)];
2419                 die "only absurd git-apply!\n" if !$use_absurd
2420                     && forceing [qw(import-gitapply-absurd)];
2421
2422                 local $ENV{DGIT_ABSURD_DEBUG} = $debuglevel if $use_absurd;
2423                 local $ENV{PATH} = $path                    if $use_absurd;
2424
2425                 my @showcmd = (gbp_pq, qw(import));
2426                 my @realcmd = shell_cmd
2427                     'exec >/dev/null 2>>../../gbp-pq-output', @showcmd;
2428                 debugcmd "+",@realcmd;
2429                 if (system @realcmd) {
2430                     die +(shellquote @showcmd).
2431                         " failed: ".
2432                         failedcmd_waitstatus()."\n";
2433                 }
2434
2435                 my $gapplied = git_rev_parse('HEAD');
2436                 my $gappliedtree = cmdoutput @git, qw(rev-parse HEAD:);
2437                 $gappliedtree eq $dappliedtree or
2438                     fail <<END;
2439 gbp-pq import and dpkg-source disagree!
2440  gbp-pq import gave commit $gapplied
2441  gbp-pq import gave tree $gappliedtree
2442  dpkg-source --before-build gave tree $dappliedtree
2443 END
2444                 $rawimport_hash = $gapplied;
2445             };
2446             last unless $@;
2447         }
2448         if ($@) {
2449             { local $@; eval { runcmd qw(cat ../../gbp-pq-output); }; }
2450             die $@;
2451         }
2452     }
2453
2454     progress "synthesised git commit from .dsc $cversion";
2455
2456     my $rawimport_mergeinput = {
2457         Commit => $rawimport_hash,
2458         Info => "Import of source package",
2459     };
2460     my @output = ($rawimport_mergeinput);
2461
2462     if ($lastpush_mergeinput) {
2463         my $oldclogp = mergeinfo_getclogp($lastpush_mergeinput);
2464         my $oversion = getfield $oldclogp, 'Version';
2465         my $vcmp =
2466             version_compare($oversion, $cversion);
2467         if ($vcmp < 0) {
2468             @output = ($rawimport_mergeinput, $lastpush_mergeinput,
2469                 { Message => <<END, ReverseParents => 1 });
2470 Record $package ($cversion) in archive suite $csuite
2471 END
2472         } elsif ($vcmp > 0) {
2473             print STDERR <<END or die $!;
2474
2475 Version actually in archive:   $cversion (older)
2476 Last version pushed with dgit: $oversion (newer or same)
2477 $later_warning_msg
2478 END
2479             @output = $lastpush_mergeinput;
2480         } else {
2481             # Same version.  Use what's in the server git branch,
2482             # discarding our own import.  (This could happen if the
2483             # server automatically imports all packages into git.)
2484             @output = $lastpush_mergeinput;
2485         }
2486     }
2487     changedir '../../../..';
2488     rmtree($ud);
2489     return @output;
2490 }
2491
2492 sub complete_file_from_dsc ($$;$) {
2493     our ($dstdir, $fi, $refetched) = @_;
2494     # Ensures that we have, in $dstdir, the file $fi, with the correct
2495     # contents.  (Downloading it from alongside $dscurl if necessary.)
2496     # If $refetched is defined, can overwrite "$dstdir/$fi->{Filename}"
2497     # and will set $$refetched=1 if it did so (or tried to).
2498
2499     my $f = $fi->{Filename};
2500     my $tf = "$dstdir/$f";
2501     my $downloaded = 0;
2502
2503     my $got;
2504     my $checkhash = sub {
2505         open F, "<", "$tf" or die "$tf: $!";
2506         $fi->{Digester}->reset();
2507         $fi->{Digester}->addfile(*F);
2508         F->error and die $!;
2509         my $got = $fi->{Digester}->hexdigest();
2510         return $got eq $fi->{Hash};
2511     };
2512
2513     if (stat_exists $tf) {
2514         if ($checkhash->()) {
2515             progress "using existing $f";
2516             return 1;
2517         }
2518         if (!$refetched) {
2519             fail "file $f has hash $got but .dsc".
2520                 " demands hash $fi->{Hash} ".
2521                 "(perhaps you should delete this file?)";
2522         }
2523         progress "need to fetch correct version of $f";
2524         unlink $tf or die "$tf $!";
2525         $$refetched = 1;
2526     } else {
2527         printdebug "$tf does not exist, need to fetch\n";
2528     }
2529
2530     my $furl = $dscurl;
2531     $furl =~ s{/[^/]+$}{};
2532     $furl .= "/$f";
2533     die "$f ?" unless $f =~ m/^\Q${package}\E_/;
2534     die "$f ?" if $f =~ m#/#;
2535     runcmd_ordryrun_local @curl,qw(-f -o),$tf,'--',"$furl";
2536     return 0 if !act_local();
2537
2538     $checkhash->() or
2539         fail "file $f has hash $got but .dsc".
2540             " demands hash $fi->{Hash} ".
2541             "(got wrong file from archive!)";
2542
2543     return 1;
2544 }
2545
2546 sub ensure_we_have_orig () {
2547     my @dfi = dsc_files_info();
2548     foreach my $fi (@dfi) {
2549         my $f = $fi->{Filename};
2550         next unless is_orig_file_in_dsc($f, \@dfi);
2551         complete_file_from_dsc('..', $fi)
2552             or next;
2553     }
2554 }
2555
2556 #---------- git fetch ----------
2557
2558 sub lrfetchrefs () { return "refs/dgit-fetch/".access_basedistro(); }
2559 sub lrfetchref () { return lrfetchrefs.'/'.server_branch($csuite); }
2560
2561 # We fetch some parts of lrfetchrefs/*.  Ideally we delete these
2562 # locally fetched refs because they have unhelpful names and clutter
2563 # up gitk etc.  So we track whether we have "used up" head ref (ie,
2564 # whether we have made another local ref which refers to this object).
2565 #
2566 # (If we deleted them unconditionally, then we might end up
2567 # re-fetching the same git objects each time dgit fetch was run.)
2568 #
2569 # So, each use of lrfetchrefs needs to be accompanied by arrangements
2570 # in git_fetch_us to fetch the refs in question, and possibly a call
2571 # to lrfetchref_used.
2572
2573 our (%lrfetchrefs_f, %lrfetchrefs_d);
2574 # $lrfetchrefs_X{lrfetchrefs."/heads/whatever"} = $objid
2575
2576 sub lrfetchref_used ($) {
2577     my ($fullrefname) = @_;
2578     my $objid = $lrfetchrefs_f{$fullrefname};
2579     $lrfetchrefs_d{$fullrefname} = $objid if defined $objid;
2580 }
2581
2582 sub git_lrfetch_sane {
2583     my ($url, $supplementary, @specs) = @_;
2584     # Make a 'refs/'.lrfetchrefs.'/*' be just like on server,
2585     # at least as regards @specs.  Also leave the results in
2586     # %lrfetchrefs_f, and arrange for lrfetchref_used to be
2587     # able to clean these up.
2588     #
2589     # With $supplementary==1, @specs must not contain wildcards
2590     # and we add to our previous fetches (non-atomically).
2591
2592     # This is rather miserable:
2593     # When git fetch --prune is passed a fetchspec ending with a *,
2594     # it does a plausible thing.  If there is no * then:
2595     # - it matches subpaths too, even if the supplied refspec
2596     #   starts refs, and behaves completely madly if the source
2597     #   has refs/refs/something.  (See, for example, Debian #NNNN.)
2598     # - if there is no matching remote ref, it bombs out the whole
2599     #   fetch.
2600     # We want to fetch a fixed ref, and we don't know in advance
2601     # if it exists, so this is not suitable.
2602     #
2603     # Our workaround is to use git ls-remote.  git ls-remote has its
2604     # own qairks.  Notably, it has the absurd multi-tail-matching
2605     # behaviour: git ls-remote R refs/foo can report refs/foo AND
2606     # refs/refs/foo etc.
2607     #
2608     # Also, we want an idempotent snapshot, but we have to make two
2609     # calls to the remote: one to git ls-remote and to git fetch.  The
2610     # solution is use git ls-remote to obtain a target state, and
2611     # git fetch to try to generate it.  If we don't manage to generate
2612     # the target state, we try again.
2613
2614     printdebug "git_lrfetch_sane suppl=$supplementary specs @specs\n";
2615
2616     my $specre = join '|', map {
2617         my $x = $_;
2618         $x =~ s/\W/\\$&/g;
2619         my $wildcard = $x =~ s/\\\*$/.*/;
2620         die if $wildcard && $supplementary;
2621         "(?:refs/$x)";
2622     } @specs;
2623     printdebug "git_lrfetch_sane specre=$specre\n";
2624     my $wanted_rref = sub {
2625         local ($_) = @_;
2626         return m/^(?:$specre)$/;
2627     };
2628
2629     my $fetch_iteration = 0;
2630     FETCH_ITERATION:
2631     for (;;) {
2632         printdebug "git_lrfetch_sane iteration $fetch_iteration\n";
2633         if (++$fetch_iteration > 10) {
2634             fail "too many iterations trying to get sane fetch!";
2635         }
2636
2637         my @look = map { "refs/$_" } @specs;
2638         my @lcmd = (@git, qw(ls-remote -q --refs), $url, @look);
2639         debugcmd "|",@lcmd;
2640
2641         my %wantr;
2642         open GITLS, "-|", @lcmd or die $!;
2643         while (<GITLS>) {
2644             printdebug "=> ", $_;
2645             m/^(\w+)\s+(\S+)\n/ or die "ls-remote $_ ?";
2646             my ($objid,$rrefname) = ($1,$2);
2647             if (!$wanted_rref->($rrefname)) {
2648                 print STDERR <<END;
2649 warning: git ls-remote @look reported $rrefname; this is silly, ignoring it.
2650 END
2651                 next;
2652             }
2653             $wantr{$rrefname} = $objid;
2654         }
2655         $!=0; $?=0;
2656         close GITLS or failedcmd @lcmd;
2657
2658         # OK, now %want is exactly what we want for refs in @specs
2659         my @fspecs = map {
2660             !m/\*$/ && !exists $wantr{"refs/$_"} ? () :
2661             "+refs/$_:".lrfetchrefs."/$_";
2662         } @specs;
2663
2664         printdebug "git_lrfetch_sane fspecs @fspecs\n";
2665
2666         my @fcmd = (@git, qw(fetch -p -n -q), $url, @fspecs);
2667         runcmd_ordryrun_local @fcmd if @fspecs;
2668
2669         if (!$supplementary) {
2670             %lrfetchrefs_f = ();
2671         }
2672         my %objgot;
2673
2674         git_for_each_ref(lrfetchrefs, sub {
2675             my ($objid,$objtype,$lrefname,$reftail) = @_;
2676             $lrfetchrefs_f{$lrefname} = $objid;
2677             $objgot{$objid} = 1;
2678         });
2679
2680         if ($supplementary) {
2681             last;
2682         }
2683
2684         foreach my $lrefname (sort keys %lrfetchrefs_f) {
2685             my $rrefname = 'refs'.substr($lrefname, length lrfetchrefs);
2686             if (!exists $wantr{$rrefname}) {
2687                 if ($wanted_rref->($rrefname)) {
2688                     printdebug <<END;
2689 git-fetch @fspecs created $lrefname which git ls-remote @look didn't list.
2690 END
2691                 } else {
2692                     print STDERR <<END
2693 warning: git fetch @fspecs created $lrefname; this is silly, deleting it.
2694 END
2695                 }
2696                 runcmd_ordryrun_local @git, qw(update-ref -d), $lrefname;
2697                 delete $lrfetchrefs_f{$lrefname};
2698                 next;
2699             }
2700         }
2701         foreach my $rrefname (sort keys %wantr) {
2702             my $lrefname = lrfetchrefs.substr($rrefname, 4);
2703             my $got = $lrfetchrefs_f{$lrefname} // '<none>';
2704             my $want = $wantr{$rrefname};
2705             next if $got eq $want;
2706             if (!defined $objgot{$want}) {
2707                 print STDERR <<END;
2708 warning: git ls-remote suggests we want $lrefname
2709 warning:  and it should refer to $want
2710 warning:  but git fetch didn't fetch that object to any relevant ref.
2711 warning:  This may be due to a race with someone updating the server.
2712 warning:  Will try again...
2713 END
2714                 next FETCH_ITERATION;
2715             }
2716             printdebug <<END;
2717 git-fetch @fspecs made $lrefname=$got but want git ls-remote @look says $want
2718 END
2719             runcmd_ordryrun_local @git, qw(update-ref -m),
2720                 "dgit fetch git fetch fixup", $lrefname, $want;
2721             $lrfetchrefs_f{$lrefname} = $want;
2722         }
2723         last;
2724     }
2725
2726     if (defined $csuite) {
2727         printdebug "git_lrfetch_sane: tidying any old suite lrfetchrefs\n";
2728         git_for_each_ref("refs/dgit-fetch/$csuite", sub {
2729             my ($objid,$objtype,$lrefname,$reftail) = @_;
2730             next if $lrfetchrefs_f{$lrefname}; # $csuite eq $distro ?
2731             runcmd_ordryrun_local @git, qw(update-ref -d), $lrefname;
2732         });
2733     }
2734
2735     printdebug "git_lrfetch_sane: git fetch --no-insane emulation complete\n",
2736         Dumper(\%lrfetchrefs_f);
2737 }
2738
2739 sub git_fetch_us () {
2740     # Want to fetch only what we are going to use, unless
2741     # deliberately-not-ff, in which case we must fetch everything.
2742
2743     my @specs = deliberately_not_fast_forward ? qw(tags/*) :
2744         map { "tags/$_" }
2745         (quiltmode_splitbrain
2746          ? (map { $_->('*',access_nomdistro) }
2747             \&debiantag_new, \&debiantag_maintview)
2748          : debiantags('*',access_nomdistro));
2749     push @specs, server_branch($csuite);
2750     push @specs, $rewritemap;
2751     push @specs, qw(heads/*) if deliberately_not_fast_forward;
2752
2753     my $url = access_giturl();
2754     git_lrfetch_sane $url, 0, @specs;
2755
2756     my %here;
2757     my @tagpats = debiantags('*',access_nomdistro);
2758
2759     git_for_each_ref([map { "refs/tags/$_" } @tagpats], sub {
2760         my ($objid,$objtype,$fullrefname,$reftail) = @_;
2761         printdebug "currently $fullrefname=$objid\n";
2762         $here{$fullrefname} = $objid;
2763     });
2764     git_for_each_ref([map { lrfetchrefs."/tags/".$_ } @tagpats], sub {
2765         my ($objid,$objtype,$fullrefname,$reftail) = @_;
2766         my $lref = "refs".substr($fullrefname, length(lrfetchrefs));
2767         printdebug "offered $lref=$objid\n";
2768         if (!defined $here{$lref}) {
2769             my @upd = (@git, qw(update-ref), $lref, $objid, '');
2770             runcmd_ordryrun_local @upd;
2771             lrfetchref_used $fullrefname;
2772         } elsif ($here{$lref} eq $objid) {
2773             lrfetchref_used $fullrefname;
2774         } else {
2775             print STDERR
2776                 "Not updating $lref from $here{$lref} to $objid.\n";
2777         }
2778     });
2779 }
2780
2781 #---------- dsc and archive handling ----------
2782
2783 sub mergeinfo_getclogp ($) {
2784     # Ensures thit $mi->{Clogp} exists and returns it
2785     my ($mi) = @_;
2786     $mi->{Clogp} = commit_getclogp($mi->{Commit});
2787 }
2788
2789 sub mergeinfo_version ($) {
2790     return getfield( (mergeinfo_getclogp $_[0]), 'Version' );
2791 }
2792
2793 sub fetch_from_archive_record_1 ($) {
2794     my ($hash) = @_;
2795     runcmd @git, qw(update-ref -m), "dgit fetch $csuite",
2796             'DGIT_ARCHIVE', $hash;
2797     cmdoutput @git, qw(log -n2), $hash;
2798     # ... gives git a chance to complain if our commit is malformed
2799 }
2800
2801 sub fetch_from_archive_record_2 ($) {
2802     my ($hash) = @_;
2803     my @upd_cmd = (@git, qw(update-ref -m), 'dgit fetch', lrref(), $hash);
2804     if (act_local()) {
2805         cmdoutput @upd_cmd;
2806     } else {
2807         dryrun_report @upd_cmd;
2808     }
2809 }
2810
2811 sub parse_dsc_field_def_dsc_distro () {
2812     $dsc_distro //= cfg qw(dgit.default.old-dsc-distro
2813                            dgit.default.distro);
2814 }
2815
2816 sub parse_dsc_field ($$) {
2817     my ($dsc, $what) = @_;
2818     my $f;
2819     foreach my $field (@ourdscfield) {
2820         $f = $dsc->{$field};
2821         last if defined $f;
2822     }
2823
2824     if (!defined $f) {
2825         progress "$what: NO git hash";
2826         parse_dsc_field_def_dsc_distro();
2827     } elsif (($dsc_hash, $dsc_distro, $dsc_hint_tag, $dsc_hint_url)
2828              = $f =~ m/^(\w+)\s+($distro_re)\s+($versiontag_re)\s+(\S+)(?:\s|$)/) {
2829         progress "$what: specified git info ($dsc_distro)";
2830         $dsc_hint_tag = [ $dsc_hint_tag ];
2831     } elsif ($f =~ m/^\w+\s*$/) {
2832         $dsc_hash = $&;
2833         parse_dsc_field_def_dsc_distro();
2834         $dsc_hint_tag = [ debiantags +(getfield $dsc, 'Version'),
2835                           $dsc_distro ];
2836         progress "$what: specified git hash";
2837     } else {
2838         fail "$what: invalid Dgit info";
2839     }
2840 }
2841
2842 sub resolve_dsc_field_commit ($$) {
2843     my ($already_distro, $already_mapref) = @_;
2844
2845     return unless defined $dsc_hash;
2846
2847     my $mapref =
2848         defined $already_mapref &&
2849         ($already_distro eq $dsc_distro || !$chase_dsc_distro)
2850         ? $already_mapref : undef;
2851
2852     my $do_fetch;
2853     $do_fetch = sub {
2854         my ($what, @fetch) = @_;
2855
2856         local $idistro = $dsc_distro;
2857         my $lrf = lrfetchrefs;
2858
2859         if (!$chase_dsc_distro) {
2860             progress
2861                 "not chasing .dsc distro $dsc_distro: not fetching $what";
2862             return 0;
2863         }
2864
2865         progress
2866             ".dsc names distro $dsc_distro: fetching $what";
2867
2868         my $url = access_giturl();
2869         if (!defined $url) {
2870             defined $dsc_hint_url or fail <<END;
2871 .dsc Dgit metadata is in context of distro $dsc_distro
2872 for which we have no configured url and .dsc provides no hint
2873 END
2874             my $proto =
2875                 $dsc_hint_url =~ m#^([-+0-9a-zA-Z]+):# ? $1 :
2876                 $dsc_hint_url =~ m#^/# ? 'file' : 'bad-syntax';
2877             parse_cfg_bool "dsc-url-proto-ok", 'false',
2878                 cfg("dgit.dsc-url-proto-ok.$proto",
2879                     "dgit.default.dsc-url-proto-ok")
2880                 or fail <<END;
2881 .dsc Dgit metadata is in context of distro $dsc_distro
2882 for which we have no configured url;
2883 .dsc provides hinted url with protocol $proto which is unsafe.
2884 (can be overridden by config - consult documentation)
2885 END
2886             $url = $dsc_hint_url;
2887         }
2888
2889         git_lrfetch_sane $url, 1, @fetch;
2890
2891         return $lrf;
2892     };
2893
2894     my $rewrite_enable = do {
2895         local $idistro = $dsc_distro;
2896         access_cfg('rewrite-map-enable', 'RETURN-UNDEF');
2897     };
2898
2899     if (parse_cfg_bool 'rewrite-map-enable', 'true', $rewrite_enable) {
2900         if (!defined $mapref) {
2901             my $lrf = $do_fetch->("rewrite map", $rewritemap) or return;
2902             $mapref = $lrf.'/'.$rewritemap;
2903         }
2904         my $rewritemapdata = git_cat_file $mapref.':map';
2905         if (defined $rewritemapdata
2906             && $rewritemapdata =~ m/^$dsc_hash(?:[ \t](\w+))/m) {
2907             progress
2908                 "server's git history rewrite map contains a relevant entry!";
2909
2910             $dsc_hash = $1;
2911             if (defined $dsc_hash) {
2912                 progress "using rewritten git hash in place of .dsc value";
2913             } else {
2914                 progress "server data says .dsc hash is to be disregarded";
2915             }
2916         }
2917     }
2918
2919     if (!defined git_cat_file $dsc_hash) {
2920         my @tags = map { "tags/".$_ } @$dsc_hint_tag;
2921         my $lrf = $do_fetch->("additional commits", @tags) &&
2922             defined git_cat_file $dsc_hash
2923             or fail <<END;
2924 .dsc Dgit metadata requires commit $dsc_hash
2925 but we could not obtain that object anywhere.
2926 END
2927         foreach my $t (@tags) {
2928             my $fullrefname = $lrf.'/'.$t;
2929 #           print STDERR "CHK $t $fullrefname ".Dumper(\%lrfetchrefs_f);
2930             next unless $lrfetchrefs_f{$fullrefname};
2931             next unless is_fast_fwd "$fullrefname~0", $dsc_hash;
2932             lrfetchref_used $fullrefname;
2933         }
2934     }
2935 }
2936
2937 sub fetch_from_archive () {
2938     ensure_setup_existing_tree();
2939
2940     # Ensures that lrref() is what is actually in the archive, one way
2941     # or another, according to us - ie this client's
2942     # appropritaely-updated archive view.  Also returns the commit id.
2943     # If there is nothing in the archive, leaves lrref alone and
2944     # returns undef.  git_fetch_us must have already been called.
2945     get_archive_dsc();
2946
2947     if ($dsc) {
2948         parse_dsc_field($dsc, 'last upload to archive');
2949         resolve_dsc_field_commit access_basedistro,
2950             lrfetchrefs."/".$rewritemap
2951     } else {
2952         progress "no version available from the archive";
2953     }
2954
2955     # If the archive's .dsc has a Dgit field, there are three
2956     # relevant git commitids we need to choose between and/or merge
2957     # together:
2958     #   1. $dsc_hash: the Dgit field from the archive
2959     #   2. $lastpush_hash: the suite branch on the dgit git server
2960     #   3. $lastfetch_hash: our local tracking brach for the suite
2961     #
2962     # These may all be distinct and need not be in any fast forward
2963     # relationship:
2964     #
2965     # If the dsc was pushed to this suite, then the server suite
2966     # branch will have been updated; but it might have been pushed to
2967     # a different suite and copied by the archive.  Conversely a more
2968     # recent version may have been pushed with dgit but not appeared
2969     # in the archive (yet).
2970     #
2971     # $lastfetch_hash may be awkward because archive imports
2972     # (particularly, imports of Dgit-less .dscs) are performed only as
2973     # needed on individual clients, so different clients may perform a
2974     # different subset of them - and these imports are only made
2975     # public during push.  So $lastfetch_hash may represent a set of
2976     # imports different to a subsequent upload by a different dgit
2977     # client.
2978     #
2979     # Our approach is as follows:
2980     #
2981     # As between $dsc_hash and $lastpush_hash: if $lastpush_hash is a
2982     # descendant of $dsc_hash, then it was pushed by a dgit user who
2983     # had based their work on $dsc_hash, so we should prefer it.
2984     # Otherwise, $dsc_hash was installed into this suite in the
2985     # archive other than by a dgit push, and (necessarily) after the
2986     # last dgit push into that suite (since a dgit push would have
2987     # been descended from the dgit server git branch); thus, in that
2988     # case, we prefer the archive's version (and produce a
2989     # pseudo-merge to overwrite the dgit server git branch).
2990     #
2991     # (If there is no Dgit field in the archive's .dsc then
2992     # generate_commit_from_dsc uses the version numbers to decide
2993     # whether the suite branch or the archive is newer.  If the suite
2994     # branch is newer it ignores the archive's .dsc; otherwise it
2995     # generates an import of the .dsc, and produces a pseudo-merge to
2996     # overwrite the suite branch with the archive contents.)
2997     #
2998     # The outcome of that part of the algorithm is the `public view',
2999     # and is same for all dgit clients: it does not depend on any
3000     # unpublished history in the local tracking branch.
3001     #
3002     # As between the public view and the local tracking branch: The
3003     # local tracking branch is only updated by dgit fetch, and
3004     # whenever dgit fetch runs it includes the public view in the
3005     # local tracking branch.  Therefore if the public view is not
3006     # descended from the local tracking branch, the local tracking
3007     # branch must contain history which was imported from the archive
3008     # but never pushed; and, its tip is now out of date.  So, we make
3009     # a pseudo-merge to overwrite the old imports and stitch the old
3010     # history in.
3011     #
3012     # Finally: we do not necessarily reify the public view (as
3013     # described above).  This is so that we do not end up stacking two
3014     # pseudo-merges.  So what we actually do is figure out the inputs
3015     # to any public view pseudo-merge and put them in @mergeinputs.
3016
3017     my @mergeinputs;
3018     # $mergeinputs[]{Commit}
3019     # $mergeinputs[]{Info}
3020     # $mergeinputs[0] is the one whose tree we use
3021     # @mergeinputs is in the order we use in the actual commit)
3022     #
3023     # Also:
3024     # $mergeinputs[]{Message} is a commit message to use
3025     # $mergeinputs[]{ReverseParents} if def specifies that parent
3026     #                                list should be in opposite order
3027     # Such an entry has no Commit or Info.  It applies only when found
3028     # in the last entry.  (This ugliness is to support making
3029     # identical imports to previous dgit versions.)
3030
3031     my $lastpush_hash = git_get_ref(lrfetchref());
3032     printdebug "previous reference hash=$lastpush_hash\n";
3033     $lastpush_mergeinput = $lastpush_hash && {
3034         Commit => $lastpush_hash,
3035         Info => "dgit suite branch on dgit git server",
3036     };
3037
3038     my $lastfetch_hash = git_get_ref(lrref());
3039     printdebug "fetch_from_archive: lastfetch=$lastfetch_hash\n";
3040     my $lastfetch_mergeinput = $lastfetch_hash && {
3041         Commit => $lastfetch_hash,
3042         Info => "dgit client's archive history view",
3043     };
3044
3045     my $dsc_mergeinput = $dsc_hash && {
3046         Commit => $dsc_hash,
3047         Info => "Dgit field in .dsc from archive",
3048     };
3049
3050     my $cwd = getcwd();
3051     my $del_lrfetchrefs = sub {
3052         changedir $cwd;
3053         my $gur;
3054         printdebug "del_lrfetchrefs...\n";
3055         foreach my $fullrefname (sort keys %lrfetchrefs_d) {
3056             my $objid = $lrfetchrefs_d{$fullrefname};
3057             printdebug "del_lrfetchrefs: $objid $fullrefname\n";
3058             if (!$gur) {
3059                 $gur ||= new IO::Handle;
3060                 open $gur, "|-", qw(git update-ref --stdin) or die $!;
3061             }
3062             printf $gur "delete %s %s\n", $fullrefname, $objid;
3063         }
3064         if ($gur) {
3065             close $gur or failedcmd "git update-ref delete lrfetchrefs";
3066         }
3067     };
3068
3069     if (defined $dsc_hash) {
3070         ensure_we_have_orig();
3071         if (!$lastpush_hash || $dsc_hash eq $lastpush_hash) {
3072             @mergeinputs = $dsc_mergeinput
3073         } elsif (is_fast_fwd($dsc_hash,$lastpush_hash)) {
3074             print STDERR <<END or die $!;
3075
3076 Git commit in archive is behind the last version allegedly pushed/uploaded.
3077 Commit referred to by archive: $dsc_hash
3078 Last version pushed with dgit: $lastpush_hash
3079 $later_warning_msg
3080 END
3081             @mergeinputs = ($lastpush_mergeinput);
3082         } else {
3083             # Archive has .dsc which is not a descendant of the last dgit
3084             # push.  This can happen if the archive moves .dscs about.
3085             # Just follow its lead.
3086             if (is_fast_fwd($lastpush_hash,$dsc_hash)) {
3087                 progress "archive .dsc names newer git commit";
3088                 @mergeinputs = ($dsc_mergeinput);
3089             } else {
3090                 progress "archive .dsc names other git commit, fixing up";
3091                 @mergeinputs = ($dsc_mergeinput, $lastpush_mergeinput);
3092             }
3093         }
3094     } elsif ($dsc) {
3095         @mergeinputs = generate_commits_from_dsc();
3096         # We have just done an import.  Now, our import algorithm might
3097         # have been improved.  But even so we do not want to generate
3098         # a new different import of the same package.  So if the
3099         # version numbers are the same, just use our existing version.
3100         # If the version numbers are different, the archive has changed
3101         # (perhaps, rewound).
3102         if ($lastfetch_mergeinput &&
3103             !version_compare( (mergeinfo_version $lastfetch_mergeinput),
3104                               (mergeinfo_version $mergeinputs[0]) )) {
3105             @mergeinputs = ($lastfetch_mergeinput);
3106         }
3107     } elsif ($lastpush_hash) {
3108         # only in git, not in the archive yet
3109         @mergeinputs = ($lastpush_mergeinput);
3110         print STDERR <<END or die $!;
3111
3112 Package not found in the archive, but has allegedly been pushed using dgit.
3113 $later_warning_msg
3114 END
3115     } else {
3116         printdebug "nothing found!\n";
3117         if (defined $skew_warning_vsn) {
3118             print STDERR <<END or die $!;
3119
3120 Warning: relevant archive skew detected.
3121 Archive allegedly contains $skew_warning_vsn
3122 But we were not able to obtain any version from the archive or git.
3123
3124 END
3125         }
3126         unshift @end, $del_lrfetchrefs;
3127         return undef;
3128     }
3129
3130     if ($lastfetch_hash &&
3131         !grep {
3132             my $h = $_->{Commit};
3133             $h and is_fast_fwd($lastfetch_hash, $h);
3134             # If true, one of the existing parents of this commit
3135             # is a descendant of the $lastfetch_hash, so we'll
3136             # be ff from that automatically.
3137         } @mergeinputs
3138         ) {
3139         # Otherwise:
3140         push @mergeinputs, $lastfetch_mergeinput;
3141     }
3142
3143     printdebug "fetch mergeinfos:\n";
3144     foreach my $mi (@mergeinputs) {
3145         if ($mi->{Info}) {
3146             printdebug " commit $mi->{Commit} $mi->{Info}\n";
3147         } else {
3148             printdebug sprintf " ReverseParents=%d Message=%s",
3149                 $mi->{ReverseParents}, $mi->{Message};
3150         }
3151     }
3152
3153     my $compat_info= pop @mergeinputs
3154         if $mergeinputs[$#mergeinputs]{Message};
3155
3156     @mergeinputs = grep { defined $_->{Commit} } @mergeinputs;
3157
3158     my $hash;
3159     if (@mergeinputs > 1) {
3160         # here we go, then:
3161         my $tree_commit = $mergeinputs[0]{Commit};
3162
3163         my $tree = cmdoutput @git, qw(cat-file commit), $tree_commit;
3164         $tree =~ m/\n\n/;  $tree = $`;
3165         $tree =~ m/^tree (\w+)$/m or die "$dsc_hash tree ?";
3166         $tree = $1;
3167
3168         # We use the changelog author of the package in question the
3169         # author of this pseudo-merge.  This is (roughly) correct if
3170         # this commit is simply representing aa non-dgit upload.
3171         # (Roughly because it does not record sponsorship - but we
3172         # don't have sponsorship info because that's in the .changes,
3173         # which isn't in the archivw.)
3174         #
3175         # But, it might be that we are representing archive history
3176         # updates (including in-archive copies).  These are not really
3177         # the responsibility of the person who created the .dsc, but
3178         # there is no-one whose name we should better use.  (The
3179         # author of the .dsc-named commit is clearly worse.)
3180
3181         my $useclogp = mergeinfo_getclogp $mergeinputs[0];
3182         my $author = clogp_authline $useclogp;
3183         my $cversion = getfield $useclogp, 'Version';
3184
3185         my $mcf = ".git/dgit/mergecommit";
3186         open MC, ">", $mcf or die "$mcf $!";
3187         print MC <<END or die $!;
3188 tree $tree
3189 END
3190
3191         my @parents = grep { $_->{Commit} } @mergeinputs;
3192         @parents = reverse @parents if $compat_info->{ReverseParents};
3193         print MC <<END or die $! foreach @parents;
3194 parent $_->{Commit}
3195 END
3196
3197         print MC <<END or die $!;
3198 author $author
3199 committer $author
3200
3201 END
3202
3203         if (defined $compat_info->{Message}) {
3204             print MC $compat_info->{Message} or die $!;
3205         } else {
3206             print MC <<END or die $!;
3207 Record $package ($cversion) in archive suite $csuite
3208
3209 Record that
3210 END
3211             my $message_add_info = sub {
3212                 my ($mi) = (@_);
3213                 my $mversion = mergeinfo_version $mi;
3214                 printf MC "  %-20s %s\n", $mversion, $mi->{Info}
3215                     or die $!;
3216             };
3217
3218             $message_add_info->($mergeinputs[0]);
3219             print MC <<END or die $!;
3220 should be treated as descended from
3221 END
3222             $message_add_info->($_) foreach @mergeinputs[1..$#mergeinputs];
3223         }
3224
3225         close MC or die $!;
3226         $hash = make_commit $mcf;
3227     } else {
3228         $hash = $mergeinputs[0]{Commit};
3229     }
3230     printdebug "fetch hash=$hash\n";
3231
3232     my $chkff = sub {
3233         my ($lasth, $what) = @_;
3234         return unless $lasth;
3235         die "$lasth $hash $what ?" unless is_fast_fwd($lasth, $hash);
3236     };
3237
3238     $chkff->($lastpush_hash, 'dgit repo server tip (last push)')
3239         if $lastpush_hash;
3240     $chkff->($lastfetch_hash, 'local tracking tip (last fetch)');
3241
3242     fetch_from_archive_record_1($hash);
3243
3244     if (defined $skew_warning_vsn) {
3245         mkpath '.git/dgit';
3246         printdebug "SKEW CHECK WANT $skew_warning_vsn\n";
3247         my $gotclogp = commit_getclogp($hash);
3248         my $got_vsn = getfield $gotclogp, 'Version';
3249         printdebug "SKEW CHECK GOT $got_vsn\n";
3250         if (version_compare($got_vsn, $skew_warning_vsn) < 0) {
3251             print STDERR <<END or die $!;
3252
3253 Warning: archive skew detected.  Using the available version:
3254 Archive allegedly contains    $skew_warning_vsn
3255 We were able to obtain only   $got_vsn
3256
3257 END
3258         }
3259     }
3260
3261     if ($lastfetch_hash ne $hash) {
3262         fetch_from_archive_record_2($hash);
3263     }
3264
3265     lrfetchref_used lrfetchref();
3266
3267     check_gitattrs($hash, "fetched source tree");
3268
3269     unshift @end, $del_lrfetchrefs;
3270     return $hash;
3271 }
3272
3273 sub set_local_git_config ($$) {
3274     my ($k, $v) = @_;
3275     runcmd @git, qw(config), $k, $v;
3276 }
3277
3278 sub setup_mergechangelogs (;$) {
3279     my ($always) = @_;
3280     return unless $always || access_cfg_bool(1, 'setup-mergechangelogs');
3281
3282     my $driver = 'dpkg-mergechangelogs';
3283     my $cb = "merge.$driver";
3284     my $attrs = '.git/info/attributes';
3285     ensuredir '.git/info';
3286
3287     open NATTRS, ">", "$attrs.new" or die "$attrs.new $!";
3288     if (!open ATTRS, "<", $attrs) {
3289         $!==ENOENT or die "$attrs: $!";
3290     } else {
3291         while (<ATTRS>) {
3292             chomp;
3293             next if m{^debian/changelog\s};
3294             print NATTRS $_, "\n" or die $!;
3295         }
3296         ATTRS->error and die $!;
3297         close ATTRS;
3298     }
3299     print NATTRS "debian/changelog merge=$driver\n" or die $!;
3300     close NATTRS;
3301
3302     set_local_git_config "$cb.name", 'debian/changelog merge driver';
3303     set_local_git_config "$cb.driver", 'dpkg-mergechangelogs -m %O %A %B %A';
3304
3305     rename "$attrs.new", "$attrs" or die "$attrs: $!";
3306 }
3307
3308 sub setup_useremail (;$) {
3309     my ($always) = @_;
3310     return unless $always || access_cfg_bool(1, 'setup-useremail');
3311
3312     my $setup = sub {
3313         my ($k, $envvar) = @_;
3314         my $v = access_cfg("user-$k", 'RETURN-UNDEF') // $ENV{$envvar};
3315         return unless defined $v;
3316         set_local_git_config "user.$k", $v;
3317     };
3318
3319     $setup->('email', 'DEBEMAIL');
3320     $setup->('name', 'DEBFULLNAME');
3321 }
3322
3323 sub ensure_setup_existing_tree () {
3324     my $k = "remote.$remotename.skipdefaultupdate";
3325     my $c = git_get_config $k;
3326     return if defined $c;
3327     set_local_git_config $k, 'true';
3328 }
3329
3330 sub open_gitattrs () {
3331     my $gai = new IO::File ".git/info/attributes"
3332         or $!==ENOENT
3333         or die "open .git/info/attributes: $!";
3334     return $gai;
3335 }
3336
3337 sub is_gitattrs_setup () {
3338     my $gai = open_gitattrs();
3339     return 0 unless $gai;
3340     while (<$gai>) {
3341         return 1 if m{^\[attr\]dgit-defuse-attrs\s};
3342     }
3343     $gai->error and die $!;
3344     return 0;
3345 }
3346
3347 sub setup_gitattrs (;$) {
3348     my ($always) = @_;
3349     return unless $always || access_cfg_bool(1, 'setup-gitattributes');
3350
3351     if (is_gitattrs_setup()) {
3352         progress <<END;
3353 [attr]dgit-defuse-attrs already found in .git/info/attributes
3354  not doing further gitattributes setup
3355 END
3356         return;
3357     }
3358     my $af = ".git/info/attributes";
3359     open GAO, "> $af.new" or die $!;
3360     print GAO <<END or die $!;
3361 *       dgit-defuse-attrs
3362 [attr]dgit-defuse-attrs -text -eol -crlf -ident -filter
3363 # ^ see GITATTRIBUTES in dgit(7) and dgit setup-new-tree in dgit(1)
3364 END
3365     my $gai = open_gitattrs();
3366     if ($gai) {
3367         while (<$gai>) {
3368             chomp;
3369             print GAO $_, "\n" or die $!;
3370         }
3371         $gai->error and die $!;
3372     }
3373     close GAO or die $!;
3374     rename "$af.new", "$af" or die "install $af: $!";
3375 }
3376
3377 sub setup_new_tree () {
3378     setup_mergechangelogs();
3379     setup_useremail();
3380     setup_gitattrs();
3381 }
3382
3383 sub check_gitattrs ($$) {
3384     my ($treeish, $what) = @_;
3385
3386     return if is_gitattrs_setup;
3387
3388     local $/="\0";
3389     my @cmd = (@git, qw(ls-tree -lrz --), "${treeish}:");
3390     debugcmd "|",@cmd;
3391     my $gafl = new IO::File;
3392     open $gafl, "-|", @cmd or die $!;
3393     while (<$gafl>) {
3394         chomp or die;
3395         s/^\d+\s+\w+\s+\w+\s+(\d+)\t// or die;
3396         next if $1 == 0;
3397         next unless m{(?:^|/)\.gitattributes$};
3398
3399         # oh dear, found one
3400         print STDERR <<END;
3401 dgit: warning: $what contains .gitattributes
3402 dgit: .gitattributes have not been defused.  Recommended: dgit setup-new-tree.
3403 END
3404         close $gafl;
3405         return;
3406     }
3407     # tree contains no .gitattributes files
3408     $?=0; $!=0; close $gafl or failedcmd @cmd;
3409 }
3410
3411
3412 sub multisuite_suite_child ($$$) {
3413     my ($tsuite, $merginputs, $fn) = @_;
3414     # in child, sets things up, calls $fn->(), and returns undef
3415     # in parent, returns canonical suite name for $tsuite
3416     my $canonsuitefh = IO::File::new_tmpfile;
3417     my $pid = fork // die $!;
3418     if (!$pid) {
3419         forkcheck_setup();
3420         $isuite = $tsuite;
3421         $us .= " [$isuite]";
3422         $debugprefix .= " ";
3423         progress "fetching $tsuite...";
3424         canonicalise_suite();
3425         print $canonsuitefh $csuite, "\n" or die $!;
3426         close $canonsuitefh or die $!;
3427         $fn->();
3428         return undef;
3429     }
3430     waitpid $pid,0 == $pid or die $!;
3431     fail "failed to obtain $tsuite: ".waitstatusmsg() if $? && $?!=256*4;
3432     seek $canonsuitefh,0,0 or die $!;
3433     local $csuite = <$canonsuitefh>;
3434     die $! unless defined $csuite && chomp $csuite;
3435     if ($? == 256*4) {
3436         printdebug "multisuite $tsuite missing\n";
3437         return $csuite;
3438     }
3439     printdebug "multisuite $tsuite ok (canon=$csuite)\n";
3440     push @$merginputs, {
3441         Ref => lrref,
3442         Info => $csuite,
3443     };
3444     return $csuite;
3445 }
3446
3447 sub fork_for_multisuite ($) {
3448     my ($before_fetch_merge) = @_;
3449     # if nothing unusual, just returns ''
3450     #
3451     # if multisuite:
3452     # returns 0 to caller in child, to do first of the specified suites
3453     # in child, $csuite is not yet set
3454     #
3455     # returns 1 to caller in parent, to finish up anything needed after
3456     # in parent, $csuite is set to canonicalised portmanteau
3457
3458     my $org_isuite = $isuite;
3459     my @suites = split /\,/, $isuite;
3460     return '' unless @suites > 1;
3461     printdebug "fork_for_multisuite: @suites\n";
3462
3463     my @mergeinputs;
3464
3465     my $cbasesuite = multisuite_suite_child($suites[0], \@mergeinputs,
3466                                             sub { });
3467     return 0 unless defined $cbasesuite;
3468
3469     fail "package $package missing in (base suite) $cbasesuite"
3470         unless @mergeinputs;
3471
3472     my @csuites = ($cbasesuite);
3473
3474     $before_fetch_merge->();
3475
3476     foreach my $tsuite (@suites[1..$#suites]) {
3477         my $csubsuite = multisuite_suite_child($tsuite, \@mergeinputs,
3478                                                sub {
3479             @end = ();
3480             fetch();
3481             exit 0;
3482         });
3483         # xxx collecte the ref here
3484
3485         $csubsuite =~ s/^\Q$cbasesuite\E-/-/;
3486         push @csuites, $csubsuite;
3487     }
3488
3489     foreach my $mi (@mergeinputs) {
3490         my $ref = git_get_ref $mi->{Ref};
3491         die "$mi->{Ref} ?" unless length $ref;
3492         $mi->{Commit} = $ref;
3493     }
3494
3495     $csuite = join ",", @csuites;
3496
3497     my $previous = git_get_ref lrref;
3498     if ($previous) {
3499         unshift @mergeinputs, {
3500             Commit => $previous,
3501             Info => "local combined tracking branch",
3502             Warning =>
3503  "archive seems to have rewound: local tracking branch is ahead!",
3504         };
3505     }
3506
3507     foreach my $ix (0..$#mergeinputs) {
3508         $mergeinputs[$ix]{Index} = $ix;
3509     }
3510
3511     @mergeinputs = sort {
3512         -version_compare(mergeinfo_version $a,
3513                          mergeinfo_version $b) # highest version first
3514             or
3515         $a->{Index} <=> $b->{Index}; # earliest in spec first
3516     } @mergeinputs;
3517
3518     my @needed;
3519
3520   NEEDED:
3521     foreach my $mi (@mergeinputs) {
3522         printdebug "multisuite merge check $mi->{Info}\n";
3523         foreach my $previous (@needed) {
3524             next unless is_fast_fwd $mi->{Commit}, $previous->{Commit};
3525             printdebug "multisuite merge un-needed $previous->{Info}\n";
3526             next NEEDED;
3527         }
3528         push @needed, $mi;
3529         printdebug "multisuite merge this-needed\n";
3530         $mi->{Character} = '+';
3531     }
3532
3533     $needed[0]{Character} = '*';
3534
3535     my $output = $needed[0]{Commit};
3536
3537     if (@needed > 1) {
3538         printdebug "multisuite merge nontrivial\n";
3539         my $tree = cmdoutput qw(git rev-parse), $needed[0]{Commit}.':';
3540
3541         my $commit = "tree $tree\n";
3542         my $msg = "Combine archive branches $csuite [dgit]\n\n".
3543             "Input branches:\n";
3544
3545         foreach my $mi (sort { $a->{Index} <=> $b->{Index} } @mergeinputs) {
3546             printdebug "multisuite merge include $mi->{Info}\n";
3547             $mi->{Character} //= ' ';
3548             $commit .= "parent $mi->{Commit}\n";
3549             $msg .= sprintf " %s  %-25s %s\n",
3550                 $mi->{Character},
3551                 (mergeinfo_version $mi),
3552                 $mi->{Info};
3553         }
3554         my $authline = clogp_authline mergeinfo_getclogp $needed[0];
3555         $msg .= "\nKey\n".
3556             " * marks the highest version branch, which choose to use\n".
3557             " + marks each branch which was not already an ancestor\n\n".
3558             "[dgit multi-suite $csuite]\n";
3559         $commit .=
3560             "author $authline\n".
3561             "committer $authline\n\n";
3562         $output = make_commit_text $commit.$msg;
3563         printdebug "multisuite merge generated $output\n";
3564     }
3565
3566     fetch_from_archive_record_1($output);
3567     fetch_from_archive_record_2($output);
3568
3569     progress "calculated combined tracking suite $csuite";
3570
3571     return 1;
3572 }
3573
3574 sub clone_set_head () {
3575     open H, "> .git/HEAD" or die $!;
3576     print H "ref: ".lref()."\n" or die $!;
3577     close H or die $!;
3578 }
3579 sub clone_finish ($) {
3580     my ($dstdir) = @_;
3581     runcmd @git, qw(reset --hard), lrref();
3582     runcmd qw(bash -ec), <<'END';
3583         set -o pipefail
3584         git ls-tree -r --name-only -z HEAD | \
3585         xargs -0r touch -h -r . --
3586 END
3587     printdone "ready for work in $dstdir";
3588 }
3589
3590 sub clone ($) {
3591     my ($dstdir) = @_;
3592     badusage "dry run makes no sense with clone" unless act_local();
3593
3594     my $multi_fetched = fork_for_multisuite(sub {
3595         printdebug "multi clone before fetch merge\n";
3596         changedir $dstdir;
3597     });
3598     if ($multi_fetched) {
3599         printdebug "multi clone after fetch merge\n";
3600         clone_set_head();
3601         clone_finish($dstdir);
3602         exit 0;
3603     }
3604     printdebug "clone main body\n";
3605
3606     canonicalise_suite();
3607     my $hasgit = check_for_git();
3608     mkdir $dstdir or fail "create \`$dstdir': $!";
3609     changedir $dstdir;
3610     runcmd @git, qw(init -q);
3611     setup_new_tree();
3612     clone_set_head();
3613     my $giturl = access_giturl(1);
3614     if (defined $giturl) {
3615         runcmd @git, qw(remote add), 'origin', $giturl;
3616     }
3617     if ($hasgit) {
3618         progress "fetching existing git history";
3619         git_fetch_us();
3620         runcmd_ordryrun_local @git, qw(fetch origin);
3621     } else {
3622         progress "starting new git history";
3623     }
3624     fetch_from_archive() or no_such_package;
3625     my $vcsgiturl = $dsc->{'Vcs-Git'};
3626     if (length $vcsgiturl) {
3627         $vcsgiturl =~ s/\s+-b\s+\S+//g;
3628         runcmd @git, qw(remote add vcs-git), $vcsgiturl;
3629     }
3630     clone_finish($dstdir);
3631 }
3632
3633 sub fetch () {
3634     canonicalise_suite();
3635     if (check_for_git()) {
3636         git_fetch_us();
3637     }
3638     fetch_from_archive() or no_such_package();
3639     printdone "fetched into ".lrref();
3640 }
3641
3642 sub pull () {
3643     my $multi_fetched = fork_for_multisuite(sub { });
3644     fetch() unless $multi_fetched; # parent
3645     return if $multi_fetched eq '0'; # child
3646     runcmd_ordryrun_local @git, qw(merge -m),"Merge from $csuite [dgit]",
3647         lrref();
3648     printdone "fetched to ".lrref()." and merged into HEAD";
3649 }
3650
3651 sub check_not_dirty () {
3652     foreach my $f (qw(local-options local-patch-header)) {
3653         if (stat_exists "debian/source/$f") {
3654             fail "git tree contains debian/source/$f";
3655         }
3656     }
3657
3658     return if $ignoredirty;
3659
3660     my @cmd = (@git, qw(diff --quiet HEAD));
3661     debugcmd "+",@cmd;
3662     $!=0; $?=-1; system @cmd;
3663     return if !$?;
3664     if ($?==256) {
3665         fail "working tree is dirty (does not match HEAD)";
3666     } else {
3667         failedcmd @cmd;
3668     }
3669 }
3670
3671 sub commit_admin ($) {
3672     my ($m) = @_;
3673     progress "$m";
3674     runcmd_ordryrun_local @git, qw(commit -m), $m;
3675 }
3676
3677 sub commit_quilty_patch () {
3678     my $output = cmdoutput @git, qw(status --porcelain);
3679     my %adds;
3680     foreach my $l (split /\n/, $output) {
3681         next unless $l =~ m/\S/;
3682         if ($l =~ m{^(?:\?\?| M) (.pc|debian/patches)}) {
3683             $adds{$1}++;
3684         }
3685     }
3686     delete $adds{'.pc'}; # if there wasn't one before, don't add it
3687     if (!%adds) {
3688         progress "nothing quilty to commit, ok.";
3689         return;
3690     }
3691     my @adds = map { s/[][*?\\]/\\$&/g; $_; } sort keys %adds;
3692     runcmd_ordryrun_local @git, qw(add -f), @adds;
3693     commit_admin <<END
3694 Commit Debian 3.0 (quilt) metadata
3695
3696 [dgit ($our_version) quilt-fixup]
3697 END
3698 }
3699
3700 sub get_source_format () {
3701     my %options;
3702     if (open F, "debian/source/options") {
3703         while (<F>) {
3704             next if m/^\s*\#/;
3705             next unless m/\S/;
3706             s/\s+$//; # ignore missing final newline
3707             if (m/\s*\#\s*/) {
3708                 my ($k, $v) = ($`, $'); #');
3709                 $v =~ s/^"(.*)"$/$1/;
3710                 $options{$k} = $v;
3711             } else {
3712                 $options{$_} = 1;
3713             }
3714         }
3715         F->error and die $!;
3716         close F;
3717     } else {
3718         die $! unless $!==&ENOENT;
3719     }
3720
3721     if (!open F, "debian/source/format") {
3722         die $! unless $!==&ENOENT;
3723         return '';
3724     }
3725     $_ = <F>;
3726     F->error and die $!;
3727     chomp;
3728     return ($_, \%options);
3729 }
3730
3731 sub madformat_wantfixup ($) {
3732     my ($format) = @_;
3733     return 0 unless $format eq '3.0 (quilt)';
3734     our $quilt_mode_warned;
3735     if ($quilt_mode eq 'nocheck') {
3736         progress "Not doing any fixup of \`$format' due to".
3737             " ----no-quilt-fixup or --quilt=nocheck"
3738             unless $quilt_mode_warned++;
3739         return 0;
3740     }
3741     progress "Format \`$format', need to check/update patch stack"
3742         unless $quilt_mode_warned++;
3743     return 1;
3744 }
3745
3746 sub maybe_split_brain_save ($$$) {
3747     my ($headref, $dgitview, $msg) = @_;
3748     # => message fragment "$saved" describing disposition of $dgitview
3749     return "commit id $dgitview" unless defined $split_brain_save;
3750     my @cmd = (shell_cmd "cd ../../../..",
3751                @git, qw(update-ref -m),
3752                "dgit --dgit-view-save $msg HEAD=$headref",
3753                $split_brain_save, $dgitview);
3754     runcmd @cmd;
3755     return "and left in $split_brain_save";
3756 }
3757
3758 # An "infopair" is a tuple [ $thing, $what ]
3759 # (often $thing is a commit hash; $what is a description)
3760
3761 sub infopair_cond_equal ($$) {
3762     my ($x,$y) = @_;
3763     $x->[0] eq $y->[0] or fail <<END;
3764 $x->[1] ($x->[0]) not equal to $y->[1] ($y->[0])
3765 END
3766 };
3767
3768 sub infopair_lrf_tag_lookup ($$) {
3769     my ($tagnames, $what) = @_;
3770     # $tagname may be an array ref
3771     my @tagnames = ref $tagnames ? @$tagnames : ($tagnames);
3772     printdebug "infopair_lrfetchref_tag_lookup $what @tagnames\n";
3773     foreach my $tagname (@tagnames) {
3774         my $lrefname = lrfetchrefs."/tags/$tagname";
3775         my $tagobj = $lrfetchrefs_f{$lrefname};
3776         next unless defined $tagobj;
3777         printdebug "infopair_lrfetchref_tag_lookup $tagobj $tagname $what\n";
3778         return [ git_rev_parse($tagobj), $what ];
3779     }
3780     fail @tagnames==1 ? <<END : <<END;
3781 Wanted tag $what (@tagnames) on dgit server, but not found
3782 END
3783 Wanted tag $what (one of: @tagnames) on dgit server, but not found
3784 END
3785 }
3786
3787 sub infopair_cond_ff ($$) {
3788     my ($anc,$desc) = @_;
3789     is_fast_fwd($anc->[0], $desc->[0]) or fail <<END;
3790 $anc->[1] ($anc->[0]) .. $desc->[1] ($desc->[0]) is not fast forward
3791 END
3792 };
3793
3794 sub pseudomerge_version_check ($$) {
3795     my ($clogp, $archive_hash) = @_;
3796
3797     my $arch_clogp = commit_getclogp $archive_hash;
3798     my $i_arch_v = [ (getfield $arch_clogp, 'Version'),
3799                      'version currently in archive' ];
3800     if (defined $overwrite_version) {
3801         if (length $overwrite_version) {
3802             infopair_cond_equal([ $overwrite_version,
3803                                   '--overwrite= version' ],
3804                                 $i_arch_v);
3805         } else {
3806             my $v = $i_arch_v->[0];
3807             progress "Checking package changelog for archive version $v ...";
3808             my $cd;
3809             eval {
3810                 my @xa = ("-f$v", "-t$v");
3811                 my $vclogp = parsechangelog @xa;
3812                 my $gf = sub {
3813                     my ($fn) = @_;
3814                     [ (getfield $vclogp, $fn),
3815                       "$fn field from dpkg-parsechangelog @xa" ];
3816                 };
3817                 my $cv = $gf->('Version');
3818                 infopair_cond_equal($i_arch_v, $cv);
3819                 $cd = $gf->('Distribution');
3820             };
3821             if ($@) {
3822                 $@ =~ s/^dgit: //gm;
3823                 fail "$@".
3824                     "Perhaps debian/changelog does not mention $v ?";
3825             }
3826             fail <<END if $cd->[0] =~ m/UNRELEASED/;
3827 $cd->[1] is $cd->[0]
3828 Your tree seems to based on earlier (not uploaded) $v.
3829 END
3830         }
3831     }
3832
3833     printdebug "pseudomerge_version_check i_arch_v @$i_arch_v\n";
3834     return $i_arch_v;
3835 }
3836
3837 sub pseudomerge_make_commit ($$$$ $$) {
3838     my ($clogp, $dgitview, $archive_hash, $i_arch_v,
3839         $msg_cmd, $msg_msg) = @_;
3840     progress "Declaring that HEAD inciudes all changes in $i_arch_v->[0]...";
3841
3842     my $tree = cmdoutput qw(git rev-parse), "${dgitview}:";
3843     my $authline = clogp_authline $clogp;
3844
3845     chomp $msg_msg;
3846     $msg_cmd .=
3847         !defined $overwrite_version ? ""
3848         : !length  $overwrite_version ? " --overwrite"
3849         : " --overwrite=".$overwrite_version;
3850
3851     mkpath '.git/dgit';
3852     my $pmf = ".git/dgit/pseudomerge";
3853     open MC, ">", $pmf or die "$pmf $!";
3854     print MC <<END or die $!;
3855 tree $tree
3856 parent $dgitview
3857 parent $archive_hash
3858 author $authline
3859 committer $authline
3860
3861 $msg_msg
3862
3863 [$msg_cmd]
3864 END
3865     close MC or die $!;
3866
3867     return make_commit($pmf);
3868 }
3869
3870 sub splitbrain_pseudomerge ($$$$) {
3871     my ($clogp, $maintview, $dgitview, $archive_hash) = @_;
3872     # => $merged_dgitview
3873     printdebug "splitbrain_pseudomerge...\n";
3874     #
3875     #     We:      debian/PREVIOUS    HEAD($maintview)
3876     # expect:          o ----------------- o
3877     #                    \                   \
3878     #                     o                   o
3879     #                 a/d/PREVIOUS        $dgitview
3880     #                $archive_hash              \
3881     #  If so,                \                   \
3882     #  we do:                 `------------------ o
3883     #   this:                                   $dgitview'
3884     #
3885
3886     return $dgitview unless defined $archive_hash;
3887
3888     printdebug "splitbrain_pseudomerge...\n";
3889
3890     my $i_arch_v = pseudomerge_version_check($clogp, $archive_hash);
3891
3892     if (!defined $overwrite_version) {
3893         progress "Checking that HEAD inciudes all changes in archive...";
3894     }
3895
3896     return $dgitview if is_fast_fwd $archive_hash, $dgitview;
3897
3898     if (defined $overwrite_version) {
3899     } elsif (!eval {
3900         my $t_dep14 = debiantag_maintview $i_arch_v->[0], access_nomdistro;
3901         my $i_dep14 = infopair_lrf_tag_lookup($t_dep14, "maintainer view tag");
3902         my $t_dgit = debiantag_new $i_arch_v->[0], access_nomdistro;
3903         my $i_dgit = infopair_lrf_tag_lookup($t_dgit, "dgit view tag");
3904         my $i_archive = [ $archive_hash, "current archive contents" ];
3905
3906         printdebug "splitbrain_pseudomerge i_archive @$i_archive\n";
3907
3908         infopair_cond_equal($i_dgit, $i_archive);
3909         infopair_cond_ff($i_dep14, $i_dgit);
3910         infopair_cond_ff($i_dep14, [ $maintview, 'HEAD' ]);
3911         1;
3912     }) {
3913         print STDERR <<END;
3914 $us: check failed (maybe --overwrite is needed, consult documentation)
3915 END
3916         die "$@";
3917     }
3918
3919     my $r = pseudomerge_make_commit
3920         $clogp, $dgitview, $archive_hash, $i_arch_v,
3921         "dgit --quilt=$quilt_mode",
3922         (defined $overwrite_version ? <<END_OVERWR : <<END_MAKEFF);
3923 Declare fast forward from $i_arch_v->[0]
3924 END_OVERWR
3925 Make fast forward from $i_arch_v->[0]
3926 END_MAKEFF
3927
3928     maybe_split_brain_save $maintview, $r, "pseudomerge";
3929
3930     progress "Made pseudo-merge of $i_arch_v->[0] into dgit view.";
3931     return $r;
3932 }
3933
3934 sub plain_overwrite_pseudomerge ($$$) {
3935     my ($clogp, $head, $archive_hash) = @_;
3936
3937     printdebug "plain_overwrite_pseudomerge...";
3938
3939     my $i_arch_v = pseudomerge_version_check($clogp, $archive_hash);
3940
3941     return $head if is_fast_fwd $archive_hash, $head;
3942
3943     my $m = "Declare fast forward from $i_arch_v->[0]";
3944
3945     my $r = pseudomerge_make_commit
3946         $clogp, $head, $archive_hash, $i_arch_v,
3947         "dgit", $m;
3948
3949     runcmd @git, qw(update-ref -m), $m, 'HEAD', $r, $head;
3950
3951     progress "Make pseudo-merge of $i_arch_v->[0] into your HEAD.";
3952     return $r;
3953 }
3954
3955 sub push_parse_changelog ($) {
3956     my ($clogpfn) = @_;
3957
3958     my $clogp = Dpkg::Control::Hash->new();
3959     $clogp->load($clogpfn) or die;
3960
3961     my $clogpackage = getfield $clogp, 'Source';
3962     $package //= $clogpackage;
3963     fail "-p specified $package but changelog specified $clogpackage"
3964         unless $package eq $clogpackage;
3965     my $cversion = getfield $clogp, 'Version';
3966
3967     if (!$we_are_initiator) {
3968         # rpush initiator can't do this because it doesn't have $isuite yet
3969         my $tag = debiantag($cversion, access_nomdistro);
3970         runcmd @git, qw(check-ref-format), $tag;
3971     }
3972
3973     my $dscfn = dscfn($cversion);
3974
3975     return ($clogp, $cversion, $dscfn);
3976 }
3977
3978 sub push_parse_dsc ($$$) {
3979     my ($dscfn,$dscfnwhat, $cversion) = @_;
3980     $dsc = parsecontrol($dscfn,$dscfnwhat);
3981     my $dversion = getfield $dsc, 'Version';
3982     my $dscpackage = getfield $dsc, 'Source';
3983     ($dscpackage eq $package && $dversion eq $cversion) or
3984         fail "$dscfn is for $dscpackage $dversion".
3985             " but debian/changelog is for $package $cversion";
3986 }
3987
3988 sub push_tagwants ($$$$) {
3989     my ($cversion, $dgithead, $maintviewhead, $tfbase) = @_;
3990     my @tagwants;
3991     push @tagwants, {
3992         TagFn => \&debiantag,
3993         Objid => $dgithead,
3994         TfSuffix => '',
3995         View => 'dgit',
3996     };
3997     if (defined $maintviewhead) {
3998         push @tagwants, {
3999             TagFn => \&debiantag_maintview,
4000             Objid => $maintviewhead,
4001             TfSuffix => '-maintview',
4002             View => 'maint',
4003         };
4004     } elsif ($dodep14tag eq 'no' ? 0
4005              : $dodep14tag eq 'want' ? access_cfg_tagformats_can_splitbrain
4006              : $dodep14tag eq 'always'
4007              ? (access_cfg_tagformats_can_splitbrain or fail <<END)
4008 --dep14tag-always (or equivalent in config) means server must support
4009  both "new" and "maint" tag formats, but config says it doesn't.
4010 END
4011             : die "$dodep14tag ?") {
4012         push @tagwants, {
4013             TagFn => \&debiantag_maintview,
4014             Objid => $dgithead,
4015             TfSuffix => '-dgit',
4016             View => 'dgit',
4017         };
4018     };
4019     foreach my $tw (@tagwants) {
4020         $tw->{Tag} = $tw->{TagFn}($cversion, access_nomdistro);
4021         $tw->{Tfn} = sub { $tfbase.$tw->{TfSuffix}.$_[0]; };
4022     }
4023     printdebug 'push_tagwants: ', Dumper(\@_, \@tagwants);
4024     return @tagwants;
4025 }
4026
4027 sub push_mktags ($$ $$ $) {
4028     my ($clogp,$dscfn,
4029         $changesfile,$changesfilewhat,
4030         $tagwants) = @_;
4031
4032     die unless $tagwants->[0]{View} eq 'dgit';
4033
4034     my $declaredistro = access_nomdistro();
4035     my $reader_giturl = do { local $access_forpush=0; access_giturl(); };
4036     $dsc->{$ourdscfield[0]} = join " ",
4037         $tagwants->[0]{Objid}, $declaredistro, $tagwants->[0]{Tag},
4038         $reader_giturl;
4039     $dsc->save("$dscfn.tmp") or die $!;
4040
4041     my $changes = parsecontrol($changesfile,$changesfilewhat);
4042     foreach my $field (qw(Source Distribution Version)) {
4043         $changes->{$field} eq $clogp->{$field} or
4044             fail "changes field $field \`$changes->{$field}'".
4045                 " does not match changelog \`$clogp->{$field}'";
4046     }
4047
4048     my $cversion = getfield $clogp, 'Version';
4049     my $clogsuite = getfield $clogp, 'Distribution';
4050
4051     # We make the git tag by hand because (a) that makes it easier
4052     # to control the "tagger" (b) we can do remote signing
4053     my $authline = clogp_authline $clogp;
4054     my $delibs = join(" ", "",@deliberatelies);
4055
4056     my $mktag = sub {
4057         my ($tw) = @_;
4058         my $tfn = $tw->{Tfn};
4059         my $head = $tw->{Objid};
4060         my $tag = $tw->{Tag};
4061
4062         open TO, '>', $tfn->('.tmp') or die $!;
4063         print TO <<END or die $!;
4064 object $head
4065 type commit
4066 tag $tag
4067 tagger $authline
4068
4069 END
4070         if ($tw->{View} eq 'dgit') {
4071             print TO <<END or die $!;
4072 $package release $cversion for $clogsuite ($csuite) [dgit]
4073 [dgit distro=$declaredistro$delibs]
4074 END
4075             foreach my $ref (sort keys %previously) {
4076                 print TO <<END or die $!;
4077 [dgit previously:$ref=$previously{$ref}]
4078 END
4079             }
4080         } elsif ($tw->{View} eq 'maint') {
4081             print TO <<END or die $!;
4082 $package release $cversion for $clogsuite ($csuite)
4083 (maintainer view tag generated by dgit --quilt=$quilt_mode)
4084 END
4085         } else {
4086             die Dumper($tw)."?";
4087         }
4088
4089         close TO or die $!;
4090
4091         my $tagobjfn = $tfn->('.tmp');
4092         if ($sign) {
4093             if (!defined $keyid) {
4094                 $keyid = access_cfg('keyid','RETURN-UNDEF');
4095             }
4096             if (!defined $keyid) {
4097                 $keyid = getfield $clogp, 'Maintainer';
4098             }
4099             unlink $tfn->('.tmp.asc') or $!==&ENOENT or die $!;
4100             my @sign_cmd = (@gpg, qw(--detach-sign --armor));
4101             push @sign_cmd, qw(-u),$keyid if defined $keyid;
4102             push @sign_cmd, $tfn->('.tmp');
4103             runcmd_ordryrun @sign_cmd;
4104             if (act_scary()) {
4105                 $tagobjfn = $tfn->('.signed.tmp');
4106                 runcmd shell_cmd "exec >$tagobjfn", qw(cat --),
4107                     $tfn->('.tmp'), $tfn->('.tmp.asc');
4108             }
4109         }
4110         return $tagobjfn;
4111     };
4112
4113     my @r = map { $mktag->($_); } @$tagwants;
4114     return @r;
4115 }
4116
4117 sub sign_changes ($) {
4118     my ($changesfile) = @_;
4119     if ($sign) {
4120         my @debsign_cmd = @debsign;
4121         push @debsign_cmd, "-k$keyid" if defined $keyid;
4122         push @debsign_cmd, "-p$gpg[0]" if $gpg[0] ne 'gpg';
4123         push @debsign_cmd, $changesfile;
4124         runcmd_ordryrun @debsign_cmd;
4125     }
4126 }
4127
4128 sub dopush () {
4129     printdebug "actually entering push\n";
4130
4131     supplementary_message(<<'END');
4132 Push failed, while checking state of the archive.
4133 You can retry the push, after fixing the problem, if you like.
4134 END
4135     if (check_for_git()) {
4136         git_fetch_us();
4137     }
4138     my $archive_hash = fetch_from_archive();
4139     if (!$archive_hash) {
4140         $new_package or
4141             fail "package appears to be new in this suite;".
4142                 " if this is intentional, use --new";
4143     }
4144
4145     supplementary_message(<<'END');
4146 Push failed, while preparing your push.
4147 You can retry the push, after fixing the problem, if you like.
4148 END
4149
4150     need_tagformat 'new', "quilt mode $quilt_mode"
4151         if quiltmode_splitbrain;
4152
4153     prep_ud();
4154
4155     access_giturl(); # check that success is vaguely likely
4156     rpush_handle_protovsn_bothends() if $we_are_initiator;
4157     select_tagformat();
4158
4159     my $clogpfn = ".git/dgit/changelog.822.tmp";
4160     runcmd shell_cmd "exec >$clogpfn", qw(dpkg-parsechangelog);
4161
4162     responder_send_file('parsed-changelog', $clogpfn);
4163
4164     my ($clogp, $cversion, $dscfn) =
4165         push_parse_changelog("$clogpfn");
4166
4167     my $dscpath = "$buildproductsdir/$dscfn";
4168     stat_exists $dscpath or
4169         fail "looked for .dsc $dscpath, but $!;".
4170             " maybe you forgot to build";
4171
4172     responder_send_file('dsc', $dscpath);
4173
4174     push_parse_dsc($dscpath, $dscfn, $cversion);
4175
4176     my $format = getfield $dsc, 'Format';
4177     printdebug "format $format\n";
4178
4179     my $actualhead = git_rev_parse('HEAD');
4180     my $dgithead = $actualhead;
4181     my $maintviewhead = undef;
4182
4183     my $upstreamversion = upstreamversion $clogp->{Version};
4184
4185     if (madformat_wantfixup($format)) {
4186         # user might have not used dgit build, so maybe do this now:
4187         if (quiltmode_splitbrain()) {
4188             changedir $ud;
4189             quilt_make_fake_dsc($upstreamversion);
4190             my $cachekey;
4191             ($dgithead, $cachekey) =
4192                 quilt_check_splitbrain_cache($actualhead, $upstreamversion);
4193             $dgithead or fail
4194  "--quilt=$quilt_mode but no cached dgit view:
4195  perhaps tree changed since dgit build[-source] ?";
4196             $split_brain = 1;
4197             $dgithead = splitbrain_pseudomerge($clogp,
4198                                                $actualhead, $dgithead,
4199                                                $archive_hash);
4200             $maintviewhead = $actualhead;
4201             changedir '../../../..';
4202             prep_ud(); # so _only_subdir() works, below
4203         } else {
4204             commit_quilty_patch();
4205         }
4206     }
4207
4208     if (defined $overwrite_version && !defined $maintviewhead) {
4209         $dgithead = plain_overwrite_pseudomerge($clogp,
4210                                                 $dgithead,
4211                                                 $archive_hash);
4212     }
4213
4214     check_not_dirty();
4215
4216     my $forceflag = '';
4217     if ($archive_hash) {
4218         if (is_fast_fwd($archive_hash, $dgithead)) {
4219             # ok
4220         } elsif (deliberately_not_fast_forward) {
4221             $forceflag = '+';
4222         } else {
4223             fail "dgit push: HEAD is not a descendant".
4224                 " of the archive's version.\n".
4225                 "To overwrite the archive's contents,".
4226                 " pass --overwrite[=VERSION].\n".
4227                 "To rewind history, if permitted by the archive,".
4228                 " use --deliberately-not-fast-forward.";
4229         }
4230     }
4231
4232     changedir $ud;
4233     progress "checking that $dscfn corresponds to HEAD";
4234     runcmd qw(dpkg-source -x --),
4235         $dscpath =~ m#^/# ? $dscpath : "../../../$dscpath";
4236     my ($tree,$dir) = mktree_in_ud_from_only_subdir("source package");
4237     check_for_vendor_patches() if madformat($dsc->{format});
4238     changedir '../../../..';
4239     my @diffcmd = (@git, qw(diff --quiet), $tree, $dgithead);
4240     debugcmd "+",@diffcmd;
4241     $!=0; $?=-1;
4242     my $r = system @diffcmd;
4243     if ($r) {
4244         if ($r==256) {
4245             my $diffs = cmdoutput @git, qw(diff --stat), $tree, $dgithead;
4246             fail <<END
4247 HEAD specifies a different tree to $dscfn:
4248 $diffs
4249 Perhaps you forgot to build.  Or perhaps there is a problem with your
4250  source tree (see dgit(7) for some hints).  To see a full diff, run
4251    git diff $tree HEAD
4252 END
4253         } else {
4254             failedcmd @diffcmd;
4255         }
4256     }
4257     if (!$changesfile) {
4258         my $pat = changespat $cversion;
4259         my @cs = glob "$buildproductsdir/$pat";
4260         fail "failed to find unique changes file".
4261             " (looked for $pat in $buildproductsdir);".
4262             " perhaps you need to use dgit -C"
4263             unless @cs==1;
4264         ($changesfile) = @cs;
4265     } else {
4266         $changesfile = "$buildproductsdir/$changesfile";
4267     }
4268
4269     # Check that changes and .dsc agree enough
4270     $changesfile =~ m{[^/]*$};
4271     my $changes = parsecontrol($changesfile,$&);
4272     files_compare_inputs($dsc, $changes)
4273         unless forceing [qw(dsc-changes-mismatch)];
4274
4275     # Perhaps adjust .dsc to contain right set of origs
4276     changes_update_origs_from_dsc($dsc, $changes, $upstreamversion,
4277                                   $changesfile)
4278         unless forceing [qw(changes-origs-exactly)];
4279
4280     # Checks complete, we're going to try and go ahead:
4281
4282     responder_send_file('changes',$changesfile);
4283     responder_send_command("param head $dgithead");
4284     responder_send_command("param csuite $csuite");
4285     responder_send_command("param isuite $isuite");
4286     responder_send_command("param tagformat $tagformat");
4287     if (defined $maintviewhead) {
4288         die unless ($protovsn//4) >= 4;
4289         responder_send_command("param maint-view $maintviewhead");
4290     }
4291
4292     if (deliberately_not_fast_forward) {
4293         git_for_each_ref(lrfetchrefs, sub {
4294             my ($objid,$objtype,$lrfetchrefname,$reftail) = @_;
4295             my $rrefname= substr($lrfetchrefname, length(lrfetchrefs) + 1);
4296             responder_send_command("previously $rrefname=$objid");
4297             $previously{$rrefname} = $objid;
4298         });
4299     }
4300
4301     my @tagwants = push_tagwants($cversion, $dgithead, $maintviewhead,
4302                                  ".git/dgit/tag");
4303     my @tagobjfns;
4304
4305     supplementary_message(<<'END');
4306 Push failed, while signing the tag.
4307 You can retry the push, after fixing the problem, if you like.
4308 END
4309     # If we manage to sign but fail to record it anywhere, it's fine.
4310     if ($we_are_responder) {
4311         @tagobjfns = map { $_->{Tfn}('.signed-tmp') } @tagwants;
4312         responder_receive_files('signed-tag', @tagobjfns);
4313     } else {
4314         @tagobjfns = push_mktags($clogp,$dscpath,
4315                               $changesfile,$changesfile,
4316                               \@tagwants);
4317     }
4318     supplementary_message(<<'END');
4319 Push failed, *after* signing the tag.
4320 If you want to try again, you should use a new version number.
4321 END
4322
4323     pairwise { $a->{TagObjFn} = $b } @tagwants, @tagobjfns;
4324
4325     foreach my $tw (@tagwants) {
4326         my $tag = $tw->{Tag};
4327         my $tagobjfn = $tw->{TagObjFn};
4328         my $tag_obj_hash =
4329             cmdoutput @git, qw(hash-object -w -t tag), $tagobjfn;
4330         runcmd_ordryrun @git, qw(verify-tag), $tag_obj_hash;
4331         runcmd_ordryrun_local
4332             @git, qw(update-ref), "refs/tags/$tag", $tag_obj_hash;
4333     }
4334
4335     supplementary_message(<<'END');
4336 Push failed, while updating the remote git repository - see messages above.
4337 If you want to try again, you should use a new version number.
4338 END
4339     if (!check_for_git()) {
4340         create_remote_git_repo();
4341     }
4342
4343     my @pushrefs = $forceflag.$dgithead.":".rrref();
4344     foreach my $tw (@tagwants) {
4345         push @pushrefs, $forceflag."refs/tags/$tw->{Tag}";
4346     }
4347
4348     runcmd_ordryrun @git,
4349         qw(-c push.followTags=false push), access_giturl(), @pushrefs;
4350     runcmd_ordryrun @git, qw(update-ref -m), 'dgit push', lrref(), $dgithead;
4351
4352     supplementary_message(<<'END');
4353 Push failed, while obtaining signatures on the .changes and .dsc.
4354 If it was just that the signature failed, you may try again by using
4355 debsign by hand to sign the changes
4356    $changesfile
4357 and then dput to complete the upload.
4358 If you need to change the package, you must use a new version number.
4359 END
4360     if ($we_are_responder) {
4361         my $dryrunsuffix = act_local() ? "" : ".tmp";
4362         responder_receive_files('signed-dsc-changes',
4363                                 "$dscpath$dryrunsuffix",
4364                                 "$changesfile$dryrunsuffix");
4365     } else {
4366         if (act_local()) {
4367             rename "$dscpath.tmp",$dscpath or die "$dscfn $!";
4368         } else {
4369             progress "[new .dsc left in $dscpath.tmp]";
4370         }
4371         sign_changes $changesfile;
4372     }
4373
4374     supplementary_message(<<END);
4375 Push failed, while uploading package(s) to the archive server.
4376 You can retry the upload of exactly these same files with dput of:
4377   $changesfile
4378 If that .changes file is broken, you will need to use a new version
4379 number for your next attempt at the upload.
4380 END
4381     my $host = access_cfg('upload-host','RETURN-UNDEF');
4382     my @hostarg = defined($host) ? ($host,) : ();
4383     runcmd_ordryrun @dput, @hostarg, $changesfile;
4384     printdone "pushed and uploaded $cversion";
4385
4386     supplementary_message('');
4387     responder_send_command("complete");
4388 }
4389
4390 sub cmd_clone {
4391     parseopts();
4392     my $dstdir;
4393     badusage "-p is not allowed with clone; specify as argument instead"
4394         if defined $package;
4395     if (@ARGV==1) {
4396         ($package) = @ARGV;
4397     } elsif (@ARGV==2 && $ARGV[1] =~ m#^\w#) {
4398         ($package,$isuite) = @ARGV;
4399     } elsif (@ARGV==2 && $ARGV[1] =~ m#^[./]#) {
4400         ($package,$dstdir) = @ARGV;
4401     } elsif (@ARGV==3) {
4402         ($package,$isuite,$dstdir) = @ARGV;
4403     } else {
4404         badusage "incorrect arguments to dgit clone";
4405     }
4406     notpushing();
4407
4408     $dstdir ||= "$package";
4409     if (stat_exists $dstdir) {
4410         fail "$dstdir already exists";
4411     }
4412
4413     my $cwd_remove;
4414     if ($rmonerror && !$dryrun_level) {
4415         $cwd_remove= getcwd();
4416         unshift @end, sub {
4417             return unless defined $cwd_remove;
4418             if (!chdir "$cwd_remove") {
4419                 return if $!==&ENOENT;
4420                 die "chdir $cwd_remove: $!";
4421             }
4422             printdebug "clone rmonerror removing $dstdir\n";
4423             if (stat $dstdir) {
4424                 rmtree($dstdir) or die "remove $dstdir: $!\n";
4425             } elsif (grep { $! == $_ }
4426                      (ENOENT, ENOTDIR, EACCES, EPERM, ELOOP)) {
4427             } else {
4428                 print STDERR "check whether to remove $dstdir: $!\n";
4429             }
4430         };
4431     }
4432
4433     clone($dstdir);
4434     $cwd_remove = undef;
4435 }
4436
4437 sub branchsuite () {
4438     my @cmd = (@git, qw(symbolic-ref HEAD));
4439     my $branch = cmdoutput_errok @cmd;
4440     if ($branch =~ m#$lbranch_re#o) {
4441         return $1;
4442     } else {
4443         return undef;
4444     }
4445 }
4446
4447 sub fetchpullargs () {
4448     if (!defined $package) {
4449         my $sourcep = parsecontrol('debian/control','debian/control');
4450         $package = getfield $sourcep, 'Source';
4451     }
4452     if (@ARGV==0) {
4453         $isuite = branchsuite();
4454         if (!$isuite) {
4455             my $clogp = parsechangelog();
4456             my $clogsuite = getfield $clogp, 'Distribution';
4457             $isuite= $clogsuite if $clogsuite ne 'UNRELEASED';
4458         }
4459     } elsif (@ARGV==1) {
4460         ($isuite) = @ARGV;
4461     } else {
4462         badusage "incorrect arguments to dgit fetch or dgit pull";
4463     }
4464     notpushing();
4465 }
4466
4467 sub cmd_fetch {
4468     parseopts();
4469     fetchpullargs();
4470     my $multi_fetched = fork_for_multisuite(sub { });
4471     exit 0 if $multi_fetched;
4472     fetch();
4473 }
4474
4475 sub cmd_pull {
4476     parseopts();
4477     fetchpullargs();
4478     if (quiltmode_splitbrain()) {
4479         my ($format, $fopts) = get_source_format();
4480         madformat($format) and fail <<END
4481 dgit pull not yet supported in split view mode (--quilt=$quilt_mode)
4482 END
4483     }
4484     pull();
4485 }
4486
4487 sub cmd_push {
4488     parseopts();
4489     badusage "-p is not allowed with dgit push" if defined $package;
4490     check_not_dirty();
4491     my $clogp = parsechangelog();
4492     $package = getfield $clogp, 'Source';
4493     my $specsuite;
4494     if (@ARGV==0) {
4495     } elsif (@ARGV==1) {
4496         ($specsuite) = (@ARGV);
4497     } else {
4498         badusage "incorrect arguments to dgit push";
4499     }
4500     $isuite = getfield $clogp, 'Distribution';
4501     pushing();
4502     if ($new_package) {
4503         local ($package) = $existing_package; # this is a hack
4504         canonicalise_suite();
4505     } else {
4506         canonicalise_suite();
4507     }
4508     if (defined $specsuite &&
4509         $specsuite ne $isuite &&
4510         $specsuite ne $csuite) {
4511             fail "dgit push: changelog specifies $isuite ($csuite)".
4512                 " but command line specifies $specsuite";
4513     }
4514     dopush();
4515 }
4516
4517 #---------- remote commands' implementation ----------
4518
4519 sub cmd_remote_push_build_host {
4520     my ($nrargs) = shift @ARGV;
4521     my (@rargs) = @ARGV[0..$nrargs-1];
4522     @ARGV = @ARGV[$nrargs..$#ARGV];
4523     die unless @rargs;
4524     my ($dir,$vsnwant) = @rargs;
4525     # vsnwant is a comma-separated list; we report which we have
4526     # chosen in our ready response (so other end can tell if they
4527     # offered several)
4528     $debugprefix = ' ';
4529     $we_are_responder = 1;
4530     $us .= " (build host)";
4531
4532     open PI, "<&STDIN" or die $!;
4533     open STDIN, "/dev/null" or die $!;
4534     open PO, ">&STDOUT" or die $!;
4535     autoflush PO 1;
4536     open STDOUT, ">&STDERR" or die $!;
4537     autoflush STDOUT 1;
4538
4539     $vsnwant //= 1;
4540     ($protovsn) = grep {
4541         $vsnwant =~ m{^(?:.*,)?$_(?:,.*)?$}
4542     } @rpushprotovsn_support;
4543
4544     fail "build host has dgit rpush protocol versions ".
4545         (join ",", @rpushprotovsn_support).
4546         " but invocation host has $vsnwant"
4547         unless defined $protovsn;
4548
4549     responder_send_command("dgit-remote-push-ready $protovsn");
4550     changedir $dir;
4551     &cmd_push;
4552 }
4553
4554 sub cmd_remote_push_responder { cmd_remote_push_build_host(); }
4555 # ... for compatibility with proto vsn.1 dgit (just so that user gets
4556 #     a good error message)
4557
4558 sub rpush_handle_protovsn_bothends () {
4559     if ($protovsn < 4) {
4560         need_tagformat 'old', "rpush negotiated protocol $protovsn";
4561     }
4562     select_tagformat();
4563 }
4564
4565 our $i_tmp;
4566
4567 sub i_cleanup {
4568     local ($@, $?);
4569     my $report = i_child_report();
4570     if (defined $report) {
4571         printdebug "($report)\n";
4572     } elsif ($i_child_pid) {
4573         printdebug "(killing build host child $i_child_pid)\n";
4574         kill 15, $i_child_pid;
4575     }
4576     if (defined $i_tmp && !defined $initiator_tempdir) {
4577         changedir "/";
4578         eval { rmtree $i_tmp; };
4579     }
4580 }
4581
4582 END {
4583     return unless forkcheck_mainprocess();
4584     i_cleanup();
4585 }
4586
4587 sub i_method {
4588     my ($base,$selector,@args) = @_;
4589     $selector =~ s/\-/_/g;
4590     { no strict qw(refs); &{"${base}_${selector}"}(@args); }
4591 }
4592
4593 sub cmd_rpush {
4594     my $host = nextarg;
4595     my $dir;
4596     if ($host =~ m/^((?:[^][]|\[[^][]*\])*)\:/) {
4597         $host = $1;
4598         $dir = $'; #';
4599     } else {
4600         $dir = nextarg;
4601     }
4602     $dir =~ s{^-}{./-};
4603     my @rargs = ($dir);
4604     push @rargs, join ",", @rpushprotovsn_support;
4605     my @rdgit;
4606     push @rdgit, @dgit;
4607     push @rdgit, @ropts;
4608     push @rdgit, qw(remote-push-build-host), (scalar @rargs), @rargs;
4609     push @rdgit, @ARGV;
4610     my @cmd = (@ssh, $host, shellquote @rdgit);
4611     debugcmd "+",@cmd;
4612
4613     $we_are_initiator=1;
4614
4615     if (defined $initiator_tempdir) {
4616         rmtree $initiator_tempdir;
4617         mkdir $initiator_tempdir, 0700 or die "$initiator_tempdir: $!";
4618         $i_tmp = $initiator_tempdir;
4619     } else {
4620         $i_tmp = tempdir();
4621     }
4622     $i_child_pid = open2(\*RO, \*RI, @cmd);
4623     changedir $i_tmp;
4624     ($protovsn) = initiator_expect { m/^dgit-remote-push-ready (\S+)/ };
4625     die "$protovsn ?" unless grep { $_ eq $protovsn } @rpushprotovsn_support;
4626     $supplementary_message = '' unless $protovsn >= 3;
4627
4628     for (;;) {
4629         my ($icmd,$iargs) = initiator_expect {
4630             m/^(\S+)(?: (.*))?$/;
4631             ($1,$2);
4632         };
4633         i_method "i_resp", $icmd, $iargs;
4634     }
4635 }
4636
4637 sub i_resp_progress ($) {
4638     my ($rhs) = @_;
4639     my $msg = protocol_read_bytes \*RO, $rhs;
4640     progress $msg;
4641 }
4642
4643 sub i_resp_supplementary_message ($) {
4644     my ($rhs) = @_;
4645     $supplementary_message = protocol_read_bytes \*RO, $rhs;
4646 }
4647
4648 sub i_resp_complete {
4649     my $pid = $i_child_pid;
4650     $i_child_pid = undef; # prevents killing some other process with same pid
4651     printdebug "waiting for build host child $pid...\n";
4652     my $got = waitpid $pid, 0;
4653     die $! unless $got == $pid;
4654     die "build host child failed $?" if $?;
4655
4656     i_cleanup();
4657     printdebug "all done\n";
4658     exit 0;
4659 }
4660
4661 sub i_resp_file ($) {
4662     my ($keyword) = @_;
4663     my $localname = i_method "i_localname", $keyword;
4664     my $localpath = "$i_tmp/$localname";
4665     stat_exists $localpath and
4666         badproto \*RO, "file $keyword ($localpath) twice";
4667     protocol_receive_file \*RO, $localpath;
4668     i_method "i_file", $keyword;
4669 }
4670
4671 our %i_param;
4672
4673 sub i_resp_param ($) {
4674     $_[0] =~ m/^(\S+) (.*)$/ or badproto \*RO, "bad param spec";
4675     $i_param{$1} = $2;
4676 }
4677
4678 sub i_resp_previously ($) {
4679     $_[0] =~ m#^(refs/tags/\S+)=(\w+)$#
4680         or badproto \*RO, "bad previously spec";
4681     my $r = system qw(git check-ref-format), $1;
4682     die "bad previously ref spec ($r)" if $r;
4683     $previously{$1} = $2;
4684 }
4685
4686 our %i_wanted;
4687
4688 sub i_resp_want ($) {
4689     my ($keyword) = @_;
4690     die "$keyword ?" if $i_wanted{$keyword}++;
4691
4692     defined $i_param{'csuite'} or badproto \*RO, "premature desire, no csuite";
4693     $isuite = $i_param{'isuite'} // $i_param{'csuite'};
4694     die unless $isuite =~ m/^$suite_re$/;
4695
4696     pushing();
4697     rpush_handle_protovsn_bothends();
4698
4699     fail "rpush negotiated protocol version $protovsn".
4700         " which does not support quilt mode $quilt_mode"
4701         if quiltmode_splitbrain;
4702
4703     my @localpaths = i_method "i_want", $keyword;
4704     printdebug "[[  $keyword @localpaths\n";
4705     foreach my $localpath (@localpaths) {
4706         protocol_send_file \*RI, $localpath;
4707     }
4708     print RI "files-end\n" or die $!;
4709 }
4710
4711 our ($i_clogp, $i_version, $i_dscfn, $i_changesfn);
4712
4713 sub i_localname_parsed_changelog {
4714     return "remote-changelog.822";
4715 }
4716 sub i_file_parsed_changelog {
4717     ($i_clogp, $i_version, $i_dscfn) =
4718         push_parse_changelog "$i_tmp/remote-changelog.822";
4719     die if $i_dscfn =~ m#/|^\W#;
4720 }
4721
4722 sub i_localname_dsc {
4723     defined $i_dscfn or badproto \*RO, "dsc (before parsed-changelog)";
4724     return $i_dscfn;
4725 }
4726 sub i_file_dsc { }
4727
4728 sub i_localname_changes {
4729     defined $i_dscfn or badproto \*RO, "dsc (before parsed-changelog)";
4730     $i_changesfn = $i_dscfn;
4731     $i_changesfn =~ s/\.dsc$/_dgit.changes/ or die;
4732     return $i_changesfn;
4733 }
4734 sub i_file_changes { }
4735
4736 sub i_want_signed_tag {
4737     printdebug Dumper(\%i_param, $i_dscfn);
4738     defined $i_param{'head'} && defined $i_dscfn && defined $i_clogp
4739         && defined $i_param{'csuite'}
4740         or badproto \*RO, "premature desire for signed-tag";
4741     my $head = $i_param{'head'};
4742     die if $head =~ m/[^0-9a-f]/ || $head !~ m/^../;
4743
4744     my $maintview = $i_param{'maint-view'};
4745     die if defined $maintview && $maintview =~ m/[^0-9a-f]/;
4746
4747     select_tagformat();
4748     if ($protovsn >= 4) {
4749         my $p = $i_param{'tagformat'} // '<undef>';
4750         $p eq $tagformat
4751             or badproto \*RO, "tag format mismatch: $p vs. $tagformat";
4752     }
4753
4754     die unless $i_param{'csuite'} =~ m/^$suite_re$/;
4755     $csuite = $&;
4756     push_parse_dsc $i_dscfn, 'remote dsc', $i_version;
4757
4758     my @tagwants = push_tagwants $i_version, $head, $maintview, "tag";
4759
4760     return
4761         push_mktags $i_clogp, $i_dscfn,
4762             $i_changesfn, 'remote changes',
4763             \@tagwants;
4764 }
4765
4766 sub i_want_signed_dsc_changes {
4767     rename "$i_dscfn.tmp","$i_dscfn" or die "$i_dscfn $!";
4768     sign_changes $i_changesfn;
4769     return ($i_dscfn, $i_changesfn);
4770 }
4771
4772 #---------- building etc. ----------
4773
4774 our $version;
4775 our $sourcechanges;
4776 our $dscfn;
4777
4778 #----- `3.0 (quilt)' handling -----
4779
4780 our $fakeeditorenv = 'DGIT_FAKE_EDITOR_QUILT';
4781
4782 sub quiltify_dpkg_commit ($$$;$) {
4783     my ($patchname,$author,$msg, $xinfo) = @_;
4784     $xinfo //= '';
4785
4786     mkpath '.git/dgit';
4787     my $descfn = ".git/dgit/quilt-description.tmp";
4788     open O, '>', $descfn or die "$descfn: $!";
4789     $msg =~ s/\n+/\n\n/;
4790     print O <<END or die $!;
4791 From: $author
4792 ${xinfo}Subject: $msg
4793 ---
4794
4795 END
4796     close O or die $!;
4797
4798     {
4799         local $ENV{'EDITOR'} = cmdoutput qw(realpath --), $0;
4800         local $ENV{'VISUAL'} = $ENV{'EDITOR'};
4801         local $ENV{$fakeeditorenv} = cmdoutput qw(realpath --), $descfn;
4802         runcmd @dpkgsource, qw(--commit --include-removal .), $patchname;
4803     }
4804 }
4805
4806 sub quiltify_trees_differ ($$;$$$) {
4807     my ($x,$y,$finegrained,$ignorenamesr,$unrepres) = @_;
4808     # returns true iff the two tree objects differ other than in debian/
4809     # with $finegrained,
4810     # returns bitmask 01 - differ in upstream files except .gitignore
4811     #                 02 - differ in .gitignore
4812     # if $ignorenamesr is defined, $ingorenamesr->{$fn}
4813     #  is set for each modified .gitignore filename $fn
4814     # if $unrepres is defined, array ref to which is appeneded
4815     #  a list of unrepresentable changes (removals of upstream files
4816     #  (as messages)
4817     local $/=undef;
4818     my @cmd = (@git, qw(diff-tree -z));
4819     push @cmd, qw(--name-only) unless $unrepres;
4820     push @cmd, qw(-r) if $finegrained || $unrepres;
4821     push @cmd, $x, $y;
4822     my $diffs= cmdoutput @cmd;
4823     my $r = 0;
4824     my @lmodes;
4825     foreach my $f (split /\0/, $diffs) {
4826         if ($unrepres && !@lmodes) {
4827             @lmodes = $f =~ m/^\:(\w+) (\w+) \w+ \w+ / or die "$_ ?";
4828             next;
4829         }
4830         my ($oldmode,$newmode) = @lmodes;
4831         @lmodes = ();
4832
4833         next if $f =~ m#^debian(?:/.*)?$#s;
4834
4835         if ($unrepres) {
4836             eval {
4837                 die "not a plain file\n"
4838                     unless $newmode =~ m/^10\d{4}$/ ||
4839                            $oldmode =~ m/^10\d{4}$/;
4840                 if ($oldmode =~ m/[^0]/ &&
4841                     $newmode =~ m/[^0]/) {
4842                     die "mode changed\n" if $oldmode ne $newmode;
4843                 } else {
4844                     die "non-default mode\n"
4845                         unless $newmode =~ m/^100644$/ ||
4846                                $oldmode =~ m/^100644$/;
4847                 }
4848             };
4849             if ($@) {
4850                 local $/="\n"; chomp $@;
4851                 push @$unrepres, [ $f, "$@ ($oldmode->$newmode)" ];
4852             }
4853         }
4854
4855         my $isignore = $f =~ m#^(?:.*/)?.gitignore$#s;
4856         $r |= $isignore ? 02 : 01;
4857         $ignorenamesr->{$f}=1 if $ignorenamesr && $isignore;
4858     }
4859     printdebug "quiltify_trees_differ $x $y => $r\n";
4860     return $r;
4861 }
4862
4863 sub quiltify_tree_sentinelfiles ($) {
4864     # lists the `sentinel' files present in the tree
4865     my ($x) = @_;
4866     my $r = cmdoutput @git, qw(ls-tree --name-only), $x,
4867         qw(-- debian/rules debian/control);
4868     $r =~ s/\n/,/g;
4869     return $r;
4870 }
4871
4872 sub quiltify_splitbrain_needed () {
4873     if (!$split_brain) {
4874         progress "dgit view: changes are required...";
4875         runcmd @git, qw(checkout -q -b dgit-view);
4876         $split_brain = 1;
4877     }
4878 }
4879
4880 sub quiltify_splitbrain ($$$$$$) {
4881     my ($clogp, $unapplied, $headref, $diffbits,
4882         $editedignores, $cachekey) = @_;
4883     if ($quilt_mode !~ m/gbp|dpm/) {
4884         # treat .gitignore just like any other upstream file
4885         $diffbits = { %$diffbits };
4886         $_ = !!$_ foreach values %$diffbits;
4887     }
4888     # We would like any commits we generate to be reproducible
4889     my @authline = clogp_authline($clogp);
4890     local $ENV{GIT_COMMITTER_NAME} =  $authline[0];
4891     local $ENV{GIT_COMMITTER_EMAIL} = $authline[1];
4892     local $ENV{GIT_COMMITTER_DATE} =  $authline[2];
4893     local $ENV{GIT_AUTHOR_NAME} =  $authline[0];
4894     local $ENV{GIT_AUTHOR_EMAIL} = $authline[1];
4895     local $ENV{GIT_AUTHOR_DATE} =  $authline[2];
4896
4897     if ($quilt_mode =~ m/gbp|unapplied/ &&
4898         ($diffbits->{O2H} & 01)) {
4899         my $msg =
4900  "--quilt=$quilt_mode specified, implying patches-unapplied git tree\n".
4901  " but git tree differs from orig in upstream files.";
4902         if (!stat_exists "debian/patches") {
4903             $msg .=
4904  "\n ... debian/patches is missing; perhaps this is a patch queue branch?";
4905         }
4906         fail $msg;
4907     }
4908     if ($quilt_mode =~ m/dpm/ &&
4909         ($diffbits->{H2A} & 01)) {
4910         fail <<END;
4911 --quilt=$quilt_mode specified, implying patches-applied git tree
4912  but git tree differs from result of applying debian/patches to upstream
4913 END
4914     }
4915     if ($quilt_mode =~ m/gbp|unapplied/ &&
4916         ($diffbits->{O2A} & 01)) { # some patches
4917         quiltify_splitbrain_needed();
4918         progress "dgit view: creating patches-applied version using gbp pq";
4919         runcmd shell_cmd 'exec >/dev/null', gbp_pq, qw(import);
4920         # gbp pq import creates a fresh branch; push back to dgit-view
4921         runcmd @git, qw(update-ref refs/heads/dgit-view HEAD);
4922         runcmd @git, qw(checkout -q dgit-view);
4923     }
4924     if ($quilt_mode =~ m/gbp|dpm/ &&
4925         ($diffbits->{O2A} & 02)) {
4926         fail <<END
4927 --quilt=$quilt_mode specified, implying that HEAD is for use with a
4928  tool which does not create patches for changes to upstream
4929  .gitignores: but, such patches exist in debian/patches.
4930 END
4931     }
4932     if (($diffbits->{O2H} & 02) && # user has modified .gitignore
4933         !($diffbits->{O2A} & 02)) { # patches do not change .gitignore
4934         quiltify_splitbrain_needed();
4935         progress "dgit view: creating patch to represent .gitignore changes";
4936         ensuredir "debian/patches";
4937         my $gipatch = "debian/patches/auto-gitignore";
4938         open GIPATCH, ">>", "$gipatch" or die "$gipatch: $!";
4939         stat GIPATCH or die "$gipatch: $!";
4940         fail "$gipatch already exists; but want to create it".
4941             " to record .gitignore changes" if (stat _)[7];
4942         print GIPATCH <<END or die "$gipatch: $!";
4943 Subject: Update .gitignore from Debian packaging branch
4944
4945 The Debian packaging git branch contains these updates to the upstream
4946 .gitignore file(s).  This patch is autogenerated, to provide these
4947 updates to users of the official Debian archive view of the package.
4948
4949 [dgit ($our_version) update-gitignore]
4950 ---
4951 END
4952         close GIPATCH or die "$gipatch: $!";
4953         runcmd shell_cmd "exec >>$gipatch", @git, qw(diff),
4954             $unapplied, $headref, "--", sort keys %$editedignores;
4955         open SERIES, "+>>", "debian/patches/series" or die $!;
4956         defined seek SERIES, -1, 2 or $!==EINVAL or die $!;
4957         my $newline;
4958         defined read SERIES, $newline, 1 or die $!;
4959         print SERIES "\n" or die $! unless $newline eq "\n";
4960         print SERIES "auto-gitignore\n" or die $!;
4961         close SERIES or die  $!;
4962         runcmd @git, qw(add -- debian/patches/series), $gipatch;
4963         commit_admin <<END
4964 Commit patch to update .gitignore
4965
4966 [dgit ($our_version) update-gitignore-quilt-fixup]
4967 END
4968     }
4969
4970     my $dgitview = git_rev_parse 'HEAD';
4971
4972     changedir '../../../..';
4973     # When we no longer need to support squeeze, use --create-reflog
4974     # instead of this:
4975     ensuredir ".git/logs/refs/dgit-intern";
4976     my $makelogfh = new IO::File ".git/logs/refs/$splitbraincache", '>>'
4977       or die $!;
4978
4979     my $oldcache = git_get_ref "refs/$splitbraincache";
4980     if ($oldcache eq $dgitview) {
4981         my $tree = cmdoutput qw(git rev-parse), "$dgitview:";
4982         # git update-ref doesn't always update, in this case.  *sigh*
4983         my $dummy = make_commit_text <<END;
4984 tree $tree
4985 parent $dgitview
4986 author Dgit <dgit\@example.com> 1000000000 +0000
4987 committer Dgit <dgit\@example.com> 1000000000 +0000
4988
4989 Dummy commit - do not use
4990 END
4991         runcmd @git, qw(update-ref -m), "dgit $our_version - dummy",
4992             "refs/$splitbraincache", $dummy;
4993     }
4994     runcmd @git, qw(update-ref -m), $cachekey, "refs/$splitbraincache",
4995         $dgitview;
4996
4997     changedir '.git/dgit/unpack/work';
4998
4999     my $saved = maybe_split_brain_save $headref, $dgitview, "converted";
5000     progress "dgit view: created ($saved)";
5001 }
5002
5003 sub quiltify ($$$$) {
5004     my ($clogp,$target,$oldtiptree,$failsuggestion) = @_;
5005
5006     # Quilt patchification algorithm
5007     #
5008     # We search backwards through the history of the main tree's HEAD
5009     # (T) looking for a start commit S whose tree object is identical
5010     # to to the patch tip tree (ie the tree corresponding to the
5011     # current dpkg-committed patch series).  For these purposes
5012     # `identical' disregards anything in debian/ - this wrinkle is
5013     # necessary because dpkg-source treates debian/ specially.
5014     #
5015     # We can only traverse edges where at most one of the ancestors'
5016     # trees differs (in changes outside in debian/).  And we cannot
5017     # handle edges which change .pc/ or debian/patches.  To avoid
5018     # going down a rathole we avoid traversing edges which introduce
5019     # debian/rules or debian/control.  And we set a limit on the
5020     # number of edges we are willing to look at.
5021     #
5022     # If we succeed, we walk forwards again.  For each traversed edge
5023     # PC (with P parent, C child) (starting with P=S and ending with
5024     # C=T) to we do this:
5025     #  - git checkout C
5026     #  - dpkg-source --commit with a patch name and message derived from C
5027     # After traversing PT, we git commit the changes which
5028     # should be contained within debian/patches.
5029
5030     # The search for the path S..T is breadth-first.  We maintain a
5031     # todo list containing search nodes.  A search node identifies a
5032     # commit, and looks something like this:
5033     #  $p = {
5034     #      Commit => $git_commit_id,
5035     #      Child => $c,                          # or undef if P=T
5036     #      Whynot => $reason_edge_PC_unsuitable, # in @nots only
5037     #      Nontrivial => true iff $p..$c has relevant changes
5038     #  };
5039
5040     my @todo;
5041     my @nots;
5042     my $sref_S;
5043     my $max_work=100;
5044     my %considered; # saves being exponential on some weird graphs
5045
5046     my $t_sentinels = quiltify_tree_sentinelfiles $target;
5047
5048     my $not = sub {
5049         my ($search,$whynot) = @_;
5050         printdebug " search NOT $search->{Commit} $whynot\n";
5051         $search->{Whynot} = $whynot;
5052         push @nots, $search;
5053         no warnings qw(exiting);
5054         next;
5055     };
5056
5057     push @todo, {
5058         Commit => $target,
5059     };
5060
5061     while (@todo) {
5062         my $c = shift @todo;
5063         next if $considered{$c->{Commit}}++;
5064
5065         $not->($c, "maximum search space exceeded") if --$max_work <= 0;
5066
5067         printdebug "quiltify investigate $c->{Commit}\n";
5068
5069         # are we done?
5070         if (!quiltify_trees_differ $c->{Commit}, $oldtiptree) {
5071             printdebug " search finished hooray!\n";
5072             $sref_S = $c;
5073             last;
5074         }
5075
5076         if ($quilt_mode eq 'nofix') {
5077             fail "quilt fixup required but quilt mode is \`nofix'\n".
5078                 "HEAD commit $c->{Commit} differs from tree implied by ".
5079                 " debian/patches (tree object $oldtiptree)";
5080         }
5081         if ($quilt_mode eq 'smash') {
5082             printdebug " search quitting smash\n";
5083             last;
5084         }
5085
5086         my $c_sentinels = quiltify_tree_sentinelfiles $c->{Commit};
5087         $not->($c, "has $c_sentinels not $t_sentinels")
5088             if $c_sentinels ne $t_sentinels;
5089
5090         my $commitdata = cmdoutput @git, qw(cat-file commit), $c->{Commit};
5091         $commitdata =~ m/\n\n/;
5092         $commitdata =~ $`;
5093         my @parents = ($commitdata =~ m/^parent (\w+)$/gm);
5094         @parents = map { { Commit => $_, Child => $c } } @parents;
5095
5096         $not->($c, "root commit") if !@parents;
5097
5098         foreach my $p (@parents) {
5099             $p->{Nontrivial}= quiltify_trees_differ $p->{Commit},$c->{Commit};
5100         }
5101         my $ndiffers = grep { $_->{Nontrivial} } @parents;
5102         $not->($c, "merge ($ndiffers nontrivial parents)") if $ndiffers > 1;
5103
5104         foreach my $p (@parents) {
5105             printdebug "considering C=$c->{Commit} P=$p->{Commit}\n";
5106
5107             my @cmd= (@git, qw(diff-tree -r --name-only),
5108                       $p->{Commit},$c->{Commit}, qw(-- debian/patches .pc));
5109             my $patchstackchange = cmdoutput @cmd;
5110             if (length $patchstackchange) {
5111                 $patchstackchange =~ s/\n/,/g;
5112                 $not->($p, "changed $patchstackchange");
5113             }
5114
5115             printdebug " search queue P=$p->{Commit} ",
5116                 ($p->{Nontrivial} ? "NT" : "triv"),"\n";
5117             push @todo, $p;
5118         }
5119     }
5120
5121     if (!$sref_S) {
5122         printdebug "quiltify want to smash\n";
5123
5124         my $abbrev = sub {
5125             my $x = $_[0]{Commit};
5126             $x =~ s/(.*?[0-9a-z]{8})[0-9a-z]*$/$1/;
5127             return $x;
5128         };
5129         my $reportnot = sub {
5130             my ($notp) = @_;
5131             my $s = $abbrev->($notp);
5132             my $c = $notp->{Child};
5133             $s .= "..".$abbrev->($c) if $c;
5134             $s .= ": ".$notp->{Whynot};
5135             return $s;
5136         };
5137         if ($quilt_mode eq 'linear') {
5138             print STDERR "$us: quilt fixup cannot be linear.  Stopped at:\n";
5139             foreach my $notp (@nots) {
5140                 print STDERR "$us:  ", $reportnot->($notp), "\n";
5141             }
5142             print STDERR "$us: $_\n" foreach @$failsuggestion;
5143             fail "quilt fixup naive history linearisation failed.\n".
5144  "Use dpkg-source --commit by hand; or, --quilt=smash for one ugly patch";
5145         } elsif ($quilt_mode eq 'smash') {
5146         } elsif ($quilt_mode eq 'auto') {
5147             progress "quilt fixup cannot be linear, smashing...";
5148         } else {
5149             die "$quilt_mode ?";
5150         }
5151
5152         my $time = $ENV{'GIT_COMMITTER_DATE'} || time;
5153         $time =~ s/\s.*//; # trim timezone from GIT_COMMITTER_DATE
5154         my $ncommits = 3;
5155         my $msg = cmdoutput @git, qw(log), "-n$ncommits";
5156
5157         quiltify_dpkg_commit "auto-$version-$target-$time",
5158             (getfield $clogp, 'Maintainer'),
5159             "Automatically generated patch ($clogp->{Version})\n".
5160             "Last (up to) $ncommits git changes, FYI:\n\n". $msg;
5161         return;
5162     }
5163
5164     progress "quiltify linearisation planning successful, executing...";
5165
5166     for (my $p = $sref_S;
5167          my $c = $p->{Child};
5168          $p = $p->{Child}) {
5169         printdebug "quiltify traverse $p->{Commit}..$c->{Commit}\n";
5170         next unless $p->{Nontrivial};
5171
5172         my $cc = $c->{Commit};
5173
5174         my $commitdata = cmdoutput @git, qw(cat-file commit), $cc;
5175         $commitdata =~ m/\n\n/ or die "$c ?";
5176         $commitdata = $`;
5177         my $msg = $'; #';
5178         $commitdata =~ m/^author (.*) \d+ [-+0-9]+$/m or die "$cc ?";
5179         my $author = $1;
5180
5181         my $commitdate = cmdoutput
5182             @git, qw(log -n1 --pretty=format:%aD), $cc;
5183
5184         $msg =~ s/^(.*)\n*/$1\n/ or die "$cc $msg ?";
5185
5186         my $strip_nls = sub { $msg =~ s/\n+$//; $msg .= "\n"; };
5187         $strip_nls->();
5188
5189         my $title = $1;
5190         my $patchname;
5191         my $patchdir;
5192
5193         my $gbp_check_suitable = sub {
5194             $_ = shift;
5195             my ($what) = @_;
5196
5197             eval {
5198                 die "contains unexpected slashes\n" if m{//} || m{/$};
5199                 die "contains leading punctuation\n" if m{^\W} || m{/\W};
5200                 die "contains bad character(s)\n" if m{[^-a-z0-9_.+=~/]}i;
5201                 die "too long" if length > 200;
5202             };
5203             return $_ unless $@;
5204             print STDERR "quiltifying commit $cc:".
5205                 " ignoring/dropping Gbp-Pq $what: $@";
5206             return undef;
5207         };
5208
5209         if ($msg =~ s/^ (?: gbp(?:-pq)? : \s* name \s+ |
5210                            gbp-pq-name: \s* )
5211                        (\S+) \s* \n //ixm) {
5212             $patchname = $gbp_check_suitable->($1, 'Name');
5213         }
5214         if ($msg =~ s/^ (?: gbp(?:-pq)? : \s* topic \s+ |
5215                            gbp-pq-topic: \s* )
5216                        (\S+) \s* \n //ixm) {
5217             $patchdir = $gbp_check_suitable->($1, 'Topic');
5218         }
5219
5220         $strip_nls->();
5221
5222         if (!defined $patchname) {
5223             $patchname = $title;
5224             $patchname =~ s/[.:]$//;
5225             use Text::Iconv;
5226             eval {
5227                 my $converter = new Text::Iconv qw(UTF-8 ASCII//TRANSLIT);
5228                 my $translitname = $converter->convert($patchname);
5229                 die unless defined $translitname;
5230                 $patchname = $translitname;
5231             };
5232             print STDERR
5233                 "dgit: patch title transliteration error: $@"
5234                 if $@;
5235             $patchname =~ y/ A-Z/-a-z/;
5236             $patchname =~ y/-a-z0-9_.+=~//cd;
5237             $patchname =~ s/^\W/x-$&/;
5238             $patchname = substr($patchname,0,40);
5239         }
5240         if (!defined $patchdir) {
5241             $patchdir = '';
5242         }
5243         if (length $patchdir) {
5244             $patchname = "$patchdir/$patchname";
5245         }
5246         if ($patchname =~ m{^(.*)/}) {
5247             mkpath "debian/patches/$1";
5248         }
5249
5250         my $index;
5251         for ($index='';
5252              stat "debian/patches/$patchname$index";
5253              $index++) { }
5254         $!==ENOENT or die "$patchname$index $!";
5255
5256         runcmd @git, qw(checkout -q), $cc;
5257
5258         # We use the tip's changelog so that dpkg-source doesn't
5259         # produce complaining messages from dpkg-parsechangelog.  None
5260         # of the information dpkg-source gets from the changelog is
5261         # actually relevant - it gets put into the original message
5262         # which dpkg-source provides our stunt editor, and then
5263         # overwritten.
5264         runcmd @git, qw(checkout -q), $target, qw(debian/changelog);
5265
5266         quiltify_dpkg_commit "$patchname$index", $author, $msg,
5267             "Date: $commitdate\n".
5268             "X-Dgit-Generated: $clogp->{Version} $cc\n";
5269
5270         runcmd @git, qw(checkout -q), $cc, qw(debian/changelog);
5271     }
5272
5273     runcmd @git, qw(checkout -q master);
5274 }
5275
5276 sub build_maybe_quilt_fixup () {
5277     my ($format,$fopts) = get_source_format;
5278     return unless madformat_wantfixup $format;
5279     # sigh
5280
5281     check_for_vendor_patches();
5282
5283     if (quiltmode_splitbrain) {
5284         fail <<END unless access_cfg_tagformats_can_splitbrain;
5285 quilt mode $quilt_mode requires split view so server needs to support
5286  both "new" and "maint" tag formats, but config says it doesn't.
5287 END
5288     }
5289
5290     my $clogp = parsechangelog();
5291     my $headref = git_rev_parse('HEAD');
5292
5293     prep_ud();
5294     changedir $ud;
5295
5296     my $upstreamversion = upstreamversion $version;
5297
5298     if ($fopts->{'single-debian-patch'}) {
5299         quilt_fixup_singlepatch($clogp, $headref, $upstreamversion);
5300     } else {
5301         quilt_fixup_multipatch($clogp, $headref, $upstreamversion);
5302     }
5303
5304     die 'bug' if $split_brain && !$need_split_build_invocation;
5305
5306     changedir '../../../..';
5307     runcmd_ordryrun_local
5308         @git, qw(pull --ff-only -q .git/dgit/unpack/work master);
5309 }
5310
5311 sub quilt_fixup_mkwork ($) {
5312     my ($headref) = @_;
5313
5314     mkdir "work" or die $!;
5315     changedir "work";
5316     mktree_in_ud_here();
5317     runcmd @git, qw(reset -q --hard), $headref;
5318 }
5319
5320 sub quilt_fixup_linkorigs ($$) {
5321     my ($upstreamversion, $fn) = @_;
5322     # calls $fn->($leafname);
5323
5324     foreach my $f (<../../../../*>) { #/){
5325         my $b=$f; $b =~ s{.*/}{};
5326         {
5327             local ($debuglevel) = $debuglevel-1;
5328             printdebug "QF linkorigs $b, $f ?\n";
5329         }
5330         next unless is_orig_file_of_vsn $b, $upstreamversion;
5331         printdebug "QF linkorigs $b, $f Y\n";
5332         link_ltarget $f, $b or die "$b $!";
5333         $fn->($b);
5334     }
5335 }
5336
5337 sub quilt_fixup_delete_pc () {
5338     runcmd @git, qw(rm -rqf .pc);
5339     commit_admin <<END
5340 Commit removal of .pc (quilt series tracking data)
5341
5342 [dgit ($our_version) upgrade quilt-remove-pc]
5343 END
5344 }
5345
5346 sub quilt_fixup_singlepatch ($$$) {
5347     my ($clogp, $headref, $upstreamversion) = @_;
5348
5349     progress "starting quiltify (single-debian-patch)";
5350
5351     # dpkg-source --commit generates new patches even if
5352     # single-debian-patch is in debian/source/options.  In order to
5353     # get it to generate debian/patches/debian-changes, it is
5354     # necessary to build the source package.
5355
5356     quilt_fixup_linkorigs($upstreamversion, sub { });
5357     quilt_fixup_mkwork($headref);
5358
5359     rmtree("debian/patches");
5360
5361     runcmd @dpkgsource, qw(-b .);
5362     changedir "..";
5363     runcmd @dpkgsource, qw(-x), (srcfn $version, ".dsc");
5364     rename srcfn("$upstreamversion", "/debian/patches"),
5365            "work/debian/patches";
5366
5367     changedir "work";
5368     commit_quilty_patch();
5369 }
5370
5371 sub quilt_make_fake_dsc ($) {
5372     my ($upstreamversion) = @_;
5373
5374     my $fakeversion="$upstreamversion-~~DGITFAKE";
5375
5376     my $fakedsc=new IO::File 'fake.dsc', '>' or die $!;
5377     print $fakedsc <<END or die $!;
5378 Format: 3.0 (quilt)
5379 Source: $package
5380 Version: $fakeversion
5381 Files:
5382 END
5383
5384     my $dscaddfile=sub {
5385         my ($b) = @_;
5386
5387         my $md = new Digest::MD5;
5388
5389         my $fh = new IO::File $b, '<' or die "$b $!";
5390         stat $fh or die $!;
5391         my $size = -s _;
5392
5393         $md->addfile($fh);
5394         print $fakedsc " ".$md->hexdigest." $size $b\n" or die $!;
5395     };
5396
5397     quilt_fixup_linkorigs($upstreamversion, $dscaddfile);
5398
5399     my @files=qw(debian/source/format debian/rules
5400                  debian/control debian/changelog);
5401     foreach my $maybe (qw(debian/patches debian/source/options
5402                           debian/tests/control)) {
5403         next unless stat_exists "../../../$maybe";
5404         push @files, $maybe;
5405     }
5406
5407     my $debtar= srcfn $fakeversion,'.debian.tar.gz';
5408     runcmd qw(env GZIP=-1n tar -zcf), "./$debtar", qw(-C ../../..), @files;
5409
5410     $dscaddfile->($debtar);
5411     close $fakedsc or die $!;
5412 }
5413
5414 sub quilt_check_splitbrain_cache ($$) {
5415     my ($headref, $upstreamversion) = @_;
5416     # Called only if we are in (potentially) split brain mode.
5417     # Called in $ud.
5418     # Computes the cache key and looks in the cache.
5419     # Returns ($dgit_view_commitid, $cachekey) or (undef, $cachekey)
5420
5421     my $splitbrain_cachekey;
5422
5423     progress
5424  "dgit: split brain (separate dgit view) may be needed (--quilt=$quilt_mode).";
5425     # we look in the reflog of dgit-intern/quilt-cache
5426     # we look for an entry whose message is the key for the cache lookup
5427     my @cachekey = (qw(dgit), $our_version);
5428     push @cachekey, $upstreamversion;
5429     push @cachekey, $quilt_mode;
5430     push @cachekey, $headref;
5431
5432     push @cachekey, hashfile('fake.dsc');
5433
5434     my $srcshash = Digest::SHA->new(256);
5435     my %sfs = ( %INC, '$0(dgit)' => $0 );
5436     foreach my $sfk (sort keys %sfs) {
5437         next unless $sfk =~ m/^\$0\b/ || $sfk =~ m{^Debian/Dgit\b};
5438         $srcshash->add($sfk,"  ");
5439         $srcshash->add(hashfile($sfs{$sfk}));
5440         $srcshash->add("\n");
5441     }
5442     push @cachekey, $srcshash->hexdigest();
5443     $splitbrain_cachekey = "@cachekey";
5444
5445     my @cmd = (@git, qw(log -g), '--pretty=format:%H %gs',
5446                $splitbraincache);
5447     printdebug "splitbrain cachekey $splitbrain_cachekey\n";
5448     debugcmd "|(probably)",@cmd;
5449     my $child = open GC, "-|";  defined $child or die $!;
5450     if (!$child) {
5451         chdir '../../..' or die $!;
5452         if (!stat ".git/logs/refs/$splitbraincache") {
5453             $! == ENOENT or die $!;
5454             printdebug ">(no reflog)\n";
5455             exit 0;
5456         }
5457         exec @cmd; die $!;
5458     }
5459     while (<GC>) {
5460         chomp;
5461         printdebug ">| ", $_, "\n" if $debuglevel > 1;
5462         next unless m/^(\w+) (\S.*\S)$/ && $2 eq $splitbrain_cachekey;
5463
5464         my $cachehit = $1;
5465         quilt_fixup_mkwork($headref);
5466         my $saved = maybe_split_brain_save $headref, $cachehit, "cache-hit";
5467         if ($cachehit ne $headref) {
5468             progress "dgit view: found cached ($saved)";
5469             runcmd @git, qw(checkout -q -b dgit-view), $cachehit;
5470             $split_brain = 1;
5471             return ($cachehit, $splitbrain_cachekey);
5472         }
5473         progress "dgit view: found cached, no changes required";
5474         return ($headref, $splitbrain_cachekey);
5475     }
5476     die $! if GC->error;
5477     failedcmd unless close GC;
5478
5479     printdebug "splitbrain cache miss\n";
5480     return (undef, $splitbrain_cachekey);
5481 }
5482
5483 sub quilt_fixup_multipatch ($$$) {
5484     my ($clogp, $headref, $upstreamversion) = @_;
5485
5486     progress "examining quilt state (multiple patches, $quilt_mode mode)";
5487
5488     # Our objective is:
5489     #  - honour any existing .pc in case it has any strangeness
5490     #  - determine the git commit corresponding to the tip of
5491     #    the patch stack (if there is one)
5492     #  - if there is such a git commit, convert each subsequent
5493     #    git commit into a quilt patch with dpkg-source --commit
5494     #  - otherwise convert all the differences in the tree into
5495     #    a single git commit
5496     #
5497     # To do this we:
5498
5499     # Our git tree doesn't necessarily contain .pc.  (Some versions of
5500     # dgit would include the .pc in the git tree.)  If there isn't
5501     # one, we need to generate one by unpacking the patches that we
5502     # have.
5503     #
5504     # We first look for a .pc in the git tree.  If there is one, we
5505     # will use it.  (This is not the normal case.)
5506     #
5507     # Otherwise need to regenerate .pc so that dpkg-source --commit
5508     # can work.  We do this as follows:
5509     #     1. Collect all relevant .orig from parent directory
5510     #     2. Generate a debian.tar.gz out of
5511     #         debian/{patches,rules,source/format,source/options}
5512     #     3. Generate a fake .dsc containing just these fields:
5513     #          Format Source Version Files
5514     #     4. Extract the fake .dsc
5515     #        Now the fake .dsc has a .pc directory.
5516     # (In fact we do this in every case, because in future we will
5517     # want to search for a good base commit for generating patches.)
5518     #
5519     # Then we can actually do the dpkg-source --commit
5520     #     1. Make a new working tree with the same object
5521     #        store as our main tree and check out the main
5522     #        tree's HEAD.
5523     #     2. Copy .pc from the fake's extraction, if necessary
5524     #     3. Run dpkg-source --commit
5525     #     4. If the result has changes to debian/, then
5526     #          - git add them them
5527     #          - git add .pc if we had a .pc in-tree
5528     #          - git commit
5529     #     5. If we had a .pc in-tree, delete it, and git commit
5530     #     6. Back in the main tree, fast forward to the new HEAD
5531
5532     # Another situation we may have to cope with is gbp-style
5533     # patches-unapplied trees.
5534     #
5535     # We would want to detect these, so we know to escape into
5536     # quilt_fixup_gbp.  However, this is in general not possible.
5537     # Consider a package with a one patch which the dgit user reverts
5538     # (with git revert or the moral equivalent).
5539     #
5540     # That is indistinguishable in contents from a patches-unapplied
5541     # tree.  And looking at the history to distinguish them is not
5542     # useful because the user might have made a confusing-looking git
5543     # history structure (which ought to produce an error if dgit can't
5544     # cope, not a silent reintroduction of an unwanted patch).
5545     #
5546     # So gbp users will have to pass an option.  But we can usually
5547     # detect their failure to do so: if the tree is not a clean
5548     # patches-applied tree, quilt linearisation fails, but the tree
5549     # _is_ a clean patches-unapplied tree, we can suggest that maybe
5550     # they want --quilt=unapplied.
5551     #
5552     # To help detect this, when we are extracting the fake dsc, we
5553     # first extract it with --skip-patches, and then apply the patches
5554     # afterwards with dpkg-source --before-build.  That lets us save a
5555     # tree object corresponding to .origs.
5556
5557     my $splitbrain_cachekey;
5558
5559     quilt_make_fake_dsc($upstreamversion);
5560
5561     if (quiltmode_splitbrain()) {
5562         my $cachehit;
5563         ($cachehit, $splitbrain_cachekey) =
5564             quilt_check_splitbrain_cache($headref, $upstreamversion);
5565         return if $cachehit;
5566     }
5567
5568     runcmd qw(sh -ec),
5569         'exec dpkg-source --no-check --skip-patches -x fake.dsc >/dev/null';
5570
5571     my $fakexdir= $package.'-'.(stripepoch $upstreamversion);
5572     rename $fakexdir, "fake" or die "$fakexdir $!";
5573
5574     changedir 'fake';
5575
5576     remove_stray_gits("source package");
5577     mktree_in_ud_here();
5578
5579     rmtree '.pc';
5580
5581     runcmd @git, qw(checkout -f), $headref, qw(-- debian);
5582     my $unapplied=git_add_write_tree();
5583     printdebug "fake orig tree object $unapplied\n";
5584
5585     ensuredir '.pc';
5586
5587     my @bbcmd = (qw(sh -ec), 'exec dpkg-source --before-build . >/dev/null');
5588     $!=0; $?=-1;
5589     if (system @bbcmd) {
5590         failedcmd @bbcmd if $? < 0;
5591         fail <<END;
5592 failed to apply your git tree's patch stack (from debian/patches/) to
5593  the corresponding upstream tarball(s).  Your source tree and .orig
5594  are probably too inconsistent.  dgit can only fix up certain kinds of
5595  anomaly (depending on the quilt mode).  See --quilt= in dgit(1).
5596 END
5597     }
5598
5599     changedir '..';
5600
5601     quilt_fixup_mkwork($headref);
5602
5603     my $mustdeletepc=0;
5604     if (stat_exists ".pc") {
5605         -d _ or die;
5606         progress "Tree already contains .pc - will use it then delete it.";
5607         $mustdeletepc=1;
5608     } else {
5609         rename '../fake/.pc','.pc' or die $!;
5610     }
5611
5612     changedir '../fake';
5613     rmtree '.pc';
5614     my $oldtiptree=git_add_write_tree();
5615     printdebug "fake o+d/p tree object $unapplied\n";
5616     changedir '../work';
5617
5618
5619     # We calculate some guesswork now about what kind of tree this might
5620     # be.  This is mostly for error reporting.
5621
5622     my %editedignores;
5623     my @unrepres;
5624     my $diffbits = {
5625         # H = user's HEAD
5626         # O = orig, without patches applied
5627         # A = "applied", ie orig with H's debian/patches applied
5628         O2H => quiltify_trees_differ($unapplied,$headref,   1,
5629                                      \%editedignores, \@unrepres),
5630         H2A => quiltify_trees_differ($headref,  $oldtiptree,1),
5631         O2A => quiltify_trees_differ($unapplied,$oldtiptree,1),
5632     };
5633
5634     my @dl;
5635     foreach my $b (qw(01 02)) {
5636         foreach my $v (qw(O2H O2A H2A)) {
5637             push @dl, ($diffbits->{$v} & $b) ? '##' : '==';
5638         }
5639     }
5640     printdebug "differences \@dl @dl.\n";
5641
5642     progress sprintf
5643 "$us: base trees orig=%.20s o+d/p=%.20s",
5644               $unapplied, $oldtiptree;
5645     progress sprintf
5646 "$us: quilt differences: src:  %s orig %s     gitignores:  %s orig %s\n".
5647 "$us: quilt differences:      HEAD %s o+d/p               HEAD %s o+d/p",
5648                              $dl[0], $dl[1],              $dl[3], $dl[4],
5649                                  $dl[2],                     $dl[5];
5650
5651     if (@unrepres) {
5652         print STDERR "dgit:  cannot represent change: $_->[1]: $_->[0]\n"
5653             foreach @unrepres;
5654         forceable_fail [qw(unrepresentable)], <<END;
5655 HEAD has changes to .orig[s] which are not representable by `3.0 (quilt)'
5656 END
5657     }
5658
5659     my @failsuggestion;
5660     if (!($diffbits->{O2H} & $diffbits->{O2A})) {
5661         push @failsuggestion, "This might be a patches-unapplied branch.";
5662     }  elsif (!($diffbits->{H2A} & $diffbits->{O2A})) {
5663         push @failsuggestion, "This might be a patches-applied branch.";
5664     }
5665     push @failsuggestion, "Maybe you need to specify one of".
5666         " --[quilt=]gbp --[quilt=]dpm --quilt=unapplied ?";
5667
5668     if (quiltmode_splitbrain()) {
5669         quiltify_splitbrain($clogp, $unapplied, $headref,
5670                             $diffbits, \%editedignores,
5671                             $splitbrain_cachekey);
5672         return;
5673     }
5674
5675     progress "starting quiltify (multiple patches, $quilt_mode mode)";
5676     quiltify($clogp,$headref,$oldtiptree,\@failsuggestion);
5677
5678     if (!open P, '>>', ".pc/applied-patches") {
5679         $!==&ENOENT or die $!;
5680     } else {
5681         close P;
5682     }
5683
5684     commit_quilty_patch();
5685
5686     if ($mustdeletepc) {
5687         quilt_fixup_delete_pc();
5688     }
5689 }
5690
5691 sub quilt_fixup_editor () {
5692     my $descfn = $ENV{$fakeeditorenv};
5693     my $editing = $ARGV[$#ARGV];
5694     open I1, '<', $descfn or die "$descfn: $!";
5695     open I2, '<', $editing or die "$editing: $!";
5696     unlink $editing or die "$editing: $!";
5697     open O, '>', $editing or die "$editing: $!";
5698     while (<I1>) { print O or die $!; } I1->error and die $!;
5699     my $copying = 0;
5700     while (<I2>) {
5701         $copying ||= m/^\-\-\- /;
5702         next unless $copying;
5703         print O or die $!;
5704     }
5705     I2->error and die $!;
5706     close O or die $1;
5707     exit 0;
5708 }
5709
5710 sub maybe_apply_patches_dirtily () {
5711     return unless $quilt_mode =~ m/gbp|unapplied/;
5712     print STDERR <<END or die $!;
5713
5714 dgit: Building, or cleaning with rules target, in patches-unapplied tree.
5715 dgit: Have to apply the patches - making the tree dirty.
5716 dgit: (Consider specifying --clean=git and (or) using dgit sbuild.)
5717
5718 END
5719     $patches_applied_dirtily = 01;
5720     $patches_applied_dirtily |= 02 unless stat_exists '.pc';
5721     runcmd qw(dpkg-source --before-build .);
5722 }
5723
5724 sub maybe_unapply_patches_again () {
5725     progress "dgit: Unapplying patches again to tidy up the tree."
5726         if $patches_applied_dirtily;
5727     runcmd qw(dpkg-source --after-build .)
5728         if $patches_applied_dirtily & 01;
5729     rmtree '.pc'
5730         if $patches_applied_dirtily & 02;
5731     $patches_applied_dirtily = 0;
5732 }
5733
5734 #----- other building -----
5735
5736 our $clean_using_builder;
5737 # ^ tree is to be cleaned by dpkg-source's builtin idea that it should
5738 #   clean the tree before building (perhaps invoked indirectly by
5739 #   whatever we are using to run the build), rather than separately
5740 #   and explicitly by us.
5741
5742 sub clean_tree () {
5743     return if $clean_using_builder;
5744     if ($cleanmode eq 'dpkg-source') {
5745         maybe_apply_patches_dirtily();
5746         runcmd_ordryrun_local @dpkgbuildpackage, qw(-T clean);
5747     } elsif ($cleanmode eq 'dpkg-source-d') {
5748         maybe_apply_patches_dirtily();
5749         runcmd_ordryrun_local @dpkgbuildpackage, qw(-d -T clean);
5750     } elsif ($cleanmode eq 'git') {
5751         runcmd_ordryrun_local @git, qw(clean -xdf);
5752     } elsif ($cleanmode eq 'git-ff') {
5753         runcmd_ordryrun_local @git, qw(clean -xdff);
5754     } elsif ($cleanmode eq 'check') {
5755         my $leftovers = cmdoutput @git, qw(clean -xdn);
5756         if (length $leftovers) {
5757             print STDERR $leftovers, "\n" or die $!;
5758             fail "tree contains uncommitted files and --clean=check specified";
5759         }
5760     } elsif ($cleanmode eq 'none') {
5761     } else {
5762         die "$cleanmode ?";
5763     }
5764 }
5765
5766 sub cmd_clean () {
5767     badusage "clean takes no additional arguments" if @ARGV;
5768     notpushing();
5769     clean_tree();
5770     maybe_unapply_patches_again();
5771 }
5772
5773 sub build_prep_early () {
5774     our $build_prep_early_done //= 0;
5775     return if $build_prep_early_done++;
5776     badusage "-p is not allowed when building" if defined $package;
5777     my $clogp = parsechangelog();
5778     $isuite = getfield $clogp, 'Distribution';
5779     $package = getfield $clogp, 'Source';
5780     $version = getfield $clogp, 'Version';
5781     notpushing();
5782     check_not_dirty();
5783 }
5784
5785 sub build_prep () {
5786     build_prep_early();
5787     clean_tree();
5788     build_maybe_quilt_fixup();
5789     if ($rmchanges) {
5790         my $pat = changespat $version;
5791         foreach my $f (glob "$buildproductsdir/$pat") {
5792             if (act_local()) {
5793                 unlink $f or fail "remove old changes file $f: $!";
5794             } else {
5795                 progress "would remove $f";
5796             }
5797         }
5798     }
5799 }
5800
5801 sub changesopts_initial () {
5802     my @opts =@changesopts[1..$#changesopts];
5803 }
5804
5805 sub changesopts_version () {
5806     if (!defined $changes_since_version) {
5807         my @vsns = archive_query('archive_query');
5808         my @quirk = access_quirk();
5809         if ($quirk[0] eq 'backports') {
5810             local $isuite = $quirk[2];
5811             local $csuite;
5812             canonicalise_suite();
5813             push @vsns, archive_query('archive_query');
5814         }
5815         if (@vsns) {
5816             @vsns = map { $_->[0] } @vsns;
5817             @vsns = sort { -version_compare($a, $b) } @vsns;
5818             $changes_since_version = $vsns[0];
5819             progress "changelog will contain changes since $vsns[0]";
5820         } else {
5821             $changes_since_version = '_';
5822             progress "package seems new, not specifying -v<version>";
5823         }
5824     }
5825     if ($changes_since_version ne '_') {
5826         return ("-v$changes_since_version");
5827     } else {
5828         return ();
5829     }
5830 }
5831
5832 sub changesopts () {
5833     return (changesopts_initial(), changesopts_version());
5834 }
5835
5836 sub massage_dbp_args ($;$) {
5837     my ($cmd,$xargs) = @_;
5838     # We need to:
5839     #
5840     #  - if we're going to split the source build out so we can
5841     #    do strange things to it, massage the arguments to dpkg-buildpackage
5842     #    so that the main build doessn't build source (or add an argument
5843     #    to stop it building source by default).
5844     #
5845     #  - add -nc to stop dpkg-source cleaning the source tree,
5846     #    unless we're not doing a split build and want dpkg-source
5847     #    as cleanmode, in which case we can do nothing
5848     #
5849     # return values:
5850     #    0 - source will NOT need to be built separately by caller
5851     #   +1 - source will need to be built separately by caller
5852     #   +2 - source will need to be built separately by caller AND
5853     #        dpkg-buildpackage should not in fact be run at all!
5854     debugcmd '#massaging#', @$cmd if $debuglevel>1;
5855 #print STDERR "MASS0 ",Dumper($cmd, $xargs, $need_split_build_invocation);
5856     if ($cleanmode eq 'dpkg-source' && !$need_split_build_invocation) {
5857         $clean_using_builder = 1;
5858         return 0;
5859     }
5860     # -nc has the side effect of specifying -b if nothing else specified
5861     # and some combinations of -S, -b, et al, are errors, rather than
5862     # later simply overriding earlie.  So we need to:
5863     #  - search the command line for these options
5864     #  - pick the last one
5865     #  - perhaps add our own as a default
5866     #  - perhaps adjust it to the corresponding non-source-building version
5867     my $dmode = '-F';
5868     foreach my $l ($cmd, $xargs) {
5869         next unless $l;
5870         @$l = grep { !(m/^-[SgGFABb]$/s and $dmode=$_) } @$l;
5871     }
5872     push @$cmd, '-nc';
5873 #print STDERR "MASS1 ",Dumper($cmd, $xargs, $dmode);
5874     my $r = 0;
5875     if ($need_split_build_invocation) {
5876         printdebug "massage split $dmode.\n";
5877         $r = $dmode =~ m/[S]/     ? +2 :
5878              $dmode =~ y/gGF/ABb/ ? +1 :
5879              $dmode =~ m/[ABb]/   ?  0 :
5880              die "$dmode ?";
5881     }
5882     printdebug "massage done $r $dmode.\n";
5883     push @$cmd, $dmode;
5884 #print STDERR "MASS2 ",Dumper($cmd, $xargs, $r);
5885     return $r;
5886 }
5887
5888 sub in_parent (&) {
5889     my ($fn) = @_;
5890     my $wasdir = must_getcwd();
5891     changedir "..";
5892     $fn->();
5893     changedir $wasdir;
5894 }
5895
5896 sub postbuild_mergechanges ($) { # must run with CWD=.. (eg in in_parent)
5897     my ($msg_if_onlyone) = @_;
5898     # If there is only one .changes file, fail with $msg_if_onlyone,
5899     # or if that is undef, be a no-op.
5900     # Returns the changes file to report to the user.
5901     my $pat = changespat $version;
5902     my @changesfiles = glob $pat;
5903     @changesfiles = sort {
5904         ($b =~ m/_source\.changes$/ <=> $a =~ m/_source\.changes$/)
5905             or $a cmp $b
5906     } @changesfiles;
5907     my $result;
5908     if (@changesfiles==1) {
5909         fail <<END.$msg_if_onlyone if defined $msg_if_onlyone;
5910 only one changes file from build (@changesfiles)
5911 END
5912         $result = $changesfiles[0];
5913     } elsif (@changesfiles==2) {
5914         my $binchanges = parsecontrol($changesfiles[1], "binary changes file");
5915         foreach my $l (split /\n/, getfield $binchanges, 'Files') {
5916             fail "$l found in binaries changes file $binchanges"
5917                 if $l =~ m/\.dsc$/;
5918         }
5919         runcmd_ordryrun_local @mergechanges, @changesfiles;
5920         my $multichanges = changespat $version,'multi';
5921         if (act_local()) {
5922             stat_exists $multichanges or fail "$multichanges: $!";
5923             foreach my $cf (glob $pat) {
5924                 next if $cf eq $multichanges;
5925                 rename "$cf", "$cf.inmulti" or fail "$cf\{,.inmulti}: $!";
5926             }
5927         }
5928         $result = $multichanges;
5929     } else {
5930         fail "wrong number of different changes files (@changesfiles)";
5931     }
5932     printdone "build successful, results in $result\n" or die $!;
5933 }
5934
5935 sub midbuild_checkchanges () {
5936     my $pat = changespat $version;
5937     return if $rmchanges;
5938     my @unwanted = map { s#^\.\./##; $_; } glob "../$pat";
5939     @unwanted = grep { $_ ne changespat $version,'source' } @unwanted;
5940     fail <<END
5941 changes files other than source matching $pat already present; building would result in ambiguity about the intended results.
5942 Suggest you delete @unwanted.
5943 END
5944         if @unwanted;
5945 }
5946
5947 sub midbuild_checkchanges_vanilla ($) {
5948     my ($wantsrc) = @_;
5949     midbuild_checkchanges() if $wantsrc == 1;
5950 }
5951
5952 sub postbuild_mergechanges_vanilla ($) {
5953     my ($wantsrc) = @_;
5954     if ($wantsrc == 1) {
5955         in_parent {
5956             postbuild_mergechanges(undef);
5957         };
5958     } else {
5959         printdone "build successful\n";
5960     }
5961 }
5962
5963 sub cmd_build {
5964     build_prep_early();
5965     my @dbp = (@dpkgbuildpackage, qw(-us -uc), changesopts_initial(), @ARGV);
5966     my $wantsrc = massage_dbp_args \@dbp;
5967     if ($wantsrc > 0) {
5968         build_source();
5969         midbuild_checkchanges_vanilla $wantsrc;
5970     } else {
5971         build_prep();
5972     }
5973     if ($wantsrc < 2) {
5974         push @dbp, changesopts_version();
5975         maybe_apply_patches_dirtily();
5976         runcmd_ordryrun_local @dbp;
5977     }
5978     maybe_unapply_patches_again();
5979     postbuild_mergechanges_vanilla $wantsrc;
5980 }
5981
5982 sub pre_gbp_build {
5983     $quilt_mode //= 'gbp';
5984 }
5985
5986 sub cmd_gbp_build {
5987     build_prep_early();
5988
5989     # gbp can make .origs out of thin air.  In my tests it does this
5990     # even for a 1.0 format package, with no origs present.  So I
5991     # guess it keys off just the version number.  We don't know
5992     # exactly what .origs ought to exist, but let's assume that we
5993     # should run gbp if: the version has an upstream part and the main
5994     # orig is absent.
5995     my $upstreamversion = upstreamversion $version;
5996     my $origfnpat = srcfn $upstreamversion, '.orig.tar.*';
5997     my $gbp_make_orig = $version =~ m/-/ && !(() = glob "../$origfnpat");
5998
5999     if ($gbp_make_orig) {
6000         clean_tree();
6001         $cleanmode = 'none'; # don't do it again
6002         $need_split_build_invocation = 1;
6003     }
6004
6005     my @dbp = @dpkgbuildpackage;
6006
6007     my $wantsrc = massage_dbp_args \@dbp, \@ARGV;
6008
6009     if (!length $gbp_build[0]) {
6010         if (length executable_on_path('git-buildpackage')) {
6011             $gbp_build[0] = qw(git-buildpackage);
6012         } else {
6013             $gbp_build[0] = 'gbp buildpackage';
6014         }
6015     }
6016     my @cmd = opts_opt_multi_cmd @gbp_build;
6017
6018     push @cmd, (qw(-us -uc --git-no-sign-tags), "--git-builder=@dbp");
6019
6020     if ($gbp_make_orig) {
6021         ensuredir '.git/dgit';
6022         my $ok = '.git/dgit/origs-gen-ok';
6023         unlink $ok or $!==&ENOENT or die $!;
6024         my @origs_cmd = @cmd;
6025         push @origs_cmd, qw(--git-cleaner=true);
6026         push @origs_cmd, "--git-prebuild=touch $ok .git/dgit/no-such-dir/ok";
6027         push @origs_cmd, @ARGV;
6028         if (act_local()) {
6029             debugcmd @origs_cmd;
6030             system @origs_cmd;
6031             do { local $!; stat_exists $ok; }
6032                 or failedcmd @origs_cmd;
6033         } else {
6034             dryrun_report @origs_cmd;
6035         }
6036     }
6037
6038     if ($wantsrc > 0) {
6039         build_source();
6040         midbuild_checkchanges_vanilla $wantsrc;
6041     } else {
6042         if (!$clean_using_builder) {
6043             push @cmd, '--git-cleaner=true';
6044         }
6045         build_prep();
6046     }
6047     maybe_unapply_patches_again();
6048     if ($wantsrc < 2) {
6049         push @cmd, changesopts();
6050         runcmd_ordryrun_local @cmd, @ARGV;
6051     }
6052     postbuild_mergechanges_vanilla $wantsrc;
6053 }
6054 sub cmd_git_build { cmd_gbp_build(); } # compatibility with <= 1.0
6055
6056 sub build_source {
6057     build_prep_early();
6058     my $our_cleanmode = $cleanmode;
6059     if ($need_split_build_invocation) {
6060         # Pretend that clean is being done some other way.  This
6061         # forces us not to try to use dpkg-buildpackage to clean and
6062         # build source all in one go; and instead we run dpkg-source
6063         # (and build_prep() will do the clean since $clean_using_builder
6064         # is false).
6065         $our_cleanmode = 'ELSEWHERE';
6066     }
6067     if ($our_cleanmode =~ m/^dpkg-source/) {
6068         # dpkg-source invocation (below) will clean, so build_prep shouldn't
6069         $clean_using_builder = 1;
6070     }
6071     build_prep();
6072     $sourcechanges = changespat $version,'source';
6073     if (act_local()) {
6074         unlink "../$sourcechanges" or $!==ENOENT
6075             or fail "remove $sourcechanges: $!";
6076     }
6077     $dscfn = dscfn($version);
6078     if ($our_cleanmode eq 'dpkg-source') {
6079         maybe_apply_patches_dirtily();
6080         runcmd_ordryrun_local @dpkgbuildpackage, qw(-us -uc -S),
6081             changesopts();
6082     } elsif ($our_cleanmode eq 'dpkg-source-d') {
6083         maybe_apply_patches_dirtily();
6084         runcmd_ordryrun_local @dpkgbuildpackage, qw(-us -uc -S -d),
6085             changesopts();
6086     } else {
6087         my @cmd = (@dpkgsource, qw(-b --));
6088         if ($split_brain) {
6089             changedir $ud;
6090             runcmd_ordryrun_local @cmd, "work";
6091             my @udfiles = <${package}_*>;
6092             changedir "../../..";
6093             foreach my $f (@udfiles) {
6094                 printdebug "source copy, found $f\n";
6095                 next unless
6096                     $f eq $dscfn or
6097                     ($f =~ m/\.debian\.tar(?:\.\w+)$/ &&
6098                      $f eq srcfn($version, $&));
6099                 printdebug "source copy, found $f - renaming\n";
6100                 rename "$ud/$f", "../$f" or $!==ENOENT
6101                     or fail "put in place new source file ($f): $!";
6102             }
6103         } else {
6104             my $pwd = must_getcwd();
6105             my $leafdir = basename $pwd;
6106             changedir "..";
6107             runcmd_ordryrun_local @cmd, $leafdir;
6108             changedir $pwd;
6109         }
6110         runcmd_ordryrun_local qw(sh -ec),
6111             'exec >$1; shift; exec "$@"','x',
6112             "../$sourcechanges",
6113             @dpkggenchanges, qw(-S), changesopts();
6114     }
6115 }
6116
6117 sub cmd_build_source {
6118     build_prep_early();
6119     badusage "build-source takes no additional arguments" if @ARGV;
6120     build_source();
6121     maybe_unapply_patches_again();
6122     printdone "source built, results in $dscfn and $sourcechanges";
6123 }
6124
6125 sub cmd_sbuild {
6126     build_source();
6127     midbuild_checkchanges();
6128     in_parent {
6129         if (act_local()) {
6130             stat_exists $dscfn or fail "$dscfn (in parent directory): $!";
6131             stat_exists $sourcechanges
6132                 or fail "$sourcechanges (in parent directory): $!";
6133         }
6134         runcmd_ordryrun_local @sbuild, qw(-d), $isuite, @ARGV, $dscfn;
6135     };
6136     maybe_unapply_patches_again();
6137     in_parent {
6138         postbuild_mergechanges(<<END);
6139 perhaps you need to pass -A ?  (sbuild's default is to build only
6140 arch-specific binaries; dgit 1.4 used to override that.)
6141 END
6142     };
6143 }
6144
6145 sub cmd_quilt_fixup {
6146     badusage "incorrect arguments to dgit quilt-fixup" if @ARGV;
6147     build_prep_early();
6148     clean_tree();
6149     build_maybe_quilt_fixup();
6150 }
6151
6152 sub import_dsc_result {
6153     my ($dstref, $newhash, $what_log, $what_msg) = @_;
6154     my @cmd = (@git, qw(update-ref -m), $what_log, $dstref, $newhash);
6155     runcmd @cmd;
6156     check_gitattrs($newhash, "source tree");
6157
6158     progress "dgit: import-dsc: $what_msg";
6159 }
6160
6161 sub cmd_import_dsc {
6162     my $needsig = 0;
6163
6164     while (@ARGV) {
6165         last unless $ARGV[0] =~ m/^-/;
6166         $_ = shift @ARGV;
6167         last if m/^--?$/;
6168         if (m/^--require-valid-signature$/) {
6169             $needsig = 1;
6170         } else {
6171             badusage "unknown dgit import-dsc sub-option \`$_'";
6172         }
6173     }
6174
6175     badusage "usage: dgit import-dsc .../PATH/TO/.DSC BRANCH" unless @ARGV==2;
6176     my ($dscfn, $dstbranch) = @ARGV;
6177
6178     badusage "dry run makes no sense with import-dsc" unless act_local();
6179
6180     my $force = $dstbranch =~ s/^\+//   ? +1 :
6181                 $dstbranch =~ s/^\.\.// ? -1 :
6182                                            0;
6183     my $info = $force ? " $&" : '';
6184     $info = "$dscfn$info";
6185
6186     my $specbranch = $dstbranch;
6187     $dstbranch = "refs/heads/$dstbranch" unless $dstbranch =~ m#^refs/#;
6188     $dstbranch = cmdoutput @git, qw(check-ref-format --normalize), $dstbranch;
6189
6190     my @symcmd = (@git, qw(symbolic-ref -q HEAD));
6191     my $chead = cmdoutput_errok @symcmd;
6192     defined $chead or $?==256 or failedcmd @symcmd;
6193
6194     fail "$dstbranch is checked out - will not update it"
6195         if defined $chead and $chead eq $dstbranch;
6196
6197     my $oldhash = git_get_ref $dstbranch;
6198
6199     open D, "<", $dscfn or fail "open import .dsc ($dscfn): $!";
6200     $dscdata = do { local $/ = undef; <D>; };
6201     D->error and fail "read $dscfn: $!";
6202     close C;
6203
6204     # we don't normally need this so import it here
6205     use Dpkg::Source::Package;
6206     my $dp = new Dpkg::Source::Package filename => $dscfn,
6207         require_valid_signature => $needsig;
6208     {
6209         local $SIG{__WARN__} = sub {
6210             print STDERR $_[0];
6211             return unless $needsig;
6212             fail "import-dsc signature check failed";
6213         };
6214         if (!$dp->is_signed()) {
6215             warn "$us: warning: importing unsigned .dsc\n";
6216         } else {
6217             my $r = $dp->check_signature();
6218             die "->check_signature => $r" if $needsig && $r;
6219         }
6220     }
6221
6222     parse_dscdata();
6223
6224     $package = getfield $dsc, 'Source';
6225
6226     parse_dsc_field($dsc, "Dgit metadata in .dsc")
6227         unless forceing [qw(import-dsc-with-dgit-field)];
6228     parse_dsc_field_def_dsc_distro();
6229
6230     $isuite = 'DGIT-IMPORT-DSC';
6231     $idistro //= $dsc_distro;
6232
6233     notpushing();
6234
6235     if (defined $dsc_hash) {
6236         progress "dgit: import-dsc of .dsc with Dgit field, using git hash";
6237         resolve_dsc_field_commit undef, undef;
6238     }
6239     if (defined $dsc_hash) {
6240         my @cmd = (qw(sh -ec),
6241                    "echo $dsc_hash | git cat-file --batch-check");
6242         my $objgot = cmdoutput @cmd;
6243         if ($objgot =~ m#^\w+ missing\b#) {
6244             fail <<END
6245 .dsc contains Dgit field referring to object $dsc_hash
6246 Your git tree does not have that object.  Try `git fetch' from a
6247 plausible server (browse.dgit.d.o? alioth?), and try the import-dsc again.
6248 END
6249         }
6250         if ($oldhash && !is_fast_fwd $oldhash, $dsc_hash) {
6251             if ($force > 0) {
6252                 progress "Not fast forward, forced update.";
6253             } else {
6254                 fail "Not fast forward to $dsc_hash";
6255             }
6256         }
6257         import_dsc_result $dstbranch, $dsc_hash,
6258             "dgit import-dsc (Dgit): $info",
6259             "updated git ref $dstbranch";
6260         return 0;
6261     }
6262
6263     fail <<END
6264 Branch $dstbranch already exists
6265 Specify ..$specbranch for a pseudo-merge, binding in existing history
6266 Specify  +$specbranch to overwrite, discarding existing history
6267 END
6268         if $oldhash && !$force;
6269
6270     my @dfi = dsc_files_info();
6271     foreach my $fi (@dfi) {
6272         my $f = $fi->{Filename};
6273         my $here = "../$f";
6274         next if lstat $here;
6275         fail "stat $here: $!" unless $! == ENOENT;
6276         my $there = $dscfn;
6277         if ($dscfn =~ m#^(?:\./+)?\.\./+#) {
6278             $there = $';
6279         } elsif ($dscfn =~ m#^/#) {
6280             $there = $dscfn;
6281         } else {
6282             fail "cannot import $dscfn which seems to be inside working tree!";
6283         }
6284         $there =~ s#/+[^/]+$## or
6285             fail "cannot import $dscfn which seems to not have a basename";
6286         $there .= "/$f";
6287         symlink $there, $here or fail "symlink $there to $here: $!";
6288         progress "made symlink $here -> $there";
6289 #       print STDERR Dumper($fi);
6290     }
6291     my @mergeinputs = generate_commits_from_dsc();
6292     die unless @mergeinputs == 1;
6293
6294     my $newhash = $mergeinputs[0]{Commit};
6295
6296     if ($oldhash) {
6297         if ($force > 0) {
6298             progress "Import, forced update - synthetic orphan git history.";
6299         } elsif ($force < 0) {
6300             progress "Import, merging.";
6301             my $tree = cmdoutput @git, qw(rev-parse), "$newhash:";
6302             my $version = getfield $dsc, 'Version';
6303             my $clogp = commit_getclogp $newhash;
6304             my $authline = clogp_authline $clogp;
6305             $newhash = make_commit_text <<END;
6306 tree $tree
6307 parent $newhash
6308 parent $oldhash
6309 author $authline
6310 committer $authline
6311
6312 Merge $package ($version) import into $dstbranch
6313 END
6314         } else {
6315             die; # caught earlier
6316         }
6317     }
6318
6319     import_dsc_result $dstbranch, $newhash,
6320         "dgit import-dsc: $info",
6321         "results are in in git ref $dstbranch";
6322 }
6323
6324 sub cmd_archive_api_query {
6325     badusage "need only 1 subpath argument" unless @ARGV==1;
6326     my ($subpath) = @ARGV;
6327     my @cmd = archive_api_query_cmd($subpath);
6328     push @cmd, qw(-f);
6329     debugcmd ">",@cmd;
6330     exec @cmd or fail "exec curl: $!\n";
6331 }
6332
6333 sub repos_server_url () {
6334     $package = '_dgit-repos-server';
6335     local $access_forpush = 1;
6336     local $isuite = 'DGIT-REPOS-SERVER';
6337     my $url = access_giturl();
6338 }
6339
6340 sub cmd_clone_dgit_repos_server {
6341     badusage "need destination argument" unless @ARGV==1;
6342     my ($destdir) = @ARGV;
6343     my $url = repos_server_url();
6344     my @cmd = (@git, qw(clone), $url, $destdir);
6345     debugcmd ">",@cmd;
6346     exec @cmd or fail "exec git clone: $!\n";
6347 }
6348
6349 sub cmd_print_dgit_repos_server_source_url {
6350     badusage "no arguments allowed to dgit print-dgit-repos-server-source-url"
6351         if @ARGV;
6352     my $url = repos_server_url();
6353     print $url, "\n" or die $!;
6354 }
6355
6356 sub cmd_setup_mergechangelogs {
6357     badusage "no arguments allowed to dgit setup-mergechangelogs" if @ARGV;
6358     local $isuite = 'DGIT-SETUP-TREE';
6359     setup_mergechangelogs(1);
6360 }
6361
6362 sub cmd_setup_useremail {
6363     badusage "no arguments allowed to dgit setup-useremail" if @ARGV;
6364     local $isuite = 'DGIT-SETUP-TREE';
6365     setup_useremail(1);
6366 }
6367
6368 sub cmd_setup_gitattributes {
6369     badusage "no arguments allowed to dgit setup-useremail" if @ARGV;
6370     local $isuite = 'DGIT-SETUP-TREE';
6371     setup_gitattrs(1);
6372 }
6373
6374 sub cmd_setup_new_tree {
6375     badusage "no arguments allowed to dgit setup-tree" if @ARGV;
6376     local $isuite = 'DGIT-SETUP-TREE';
6377     setup_new_tree();
6378 }
6379
6380 #---------- argument parsing and main program ----------
6381
6382 sub cmd_version {
6383     print "dgit version $our_version\n" or die $!;
6384     exit 0;
6385 }
6386
6387 our (%valopts_long, %valopts_short);
6388 our (%funcopts_long);
6389 our @rvalopts;
6390 our (@modeopt_cfgs);
6391
6392 sub defvalopt ($$$$) {
6393     my ($long,$short,$val_re,$how) = @_;
6394     my $oi = { Long => $long, Short => $short, Re => $val_re, How => $how };
6395     $valopts_long{$long} = $oi;
6396     $valopts_short{$short} = $oi;
6397     # $how subref should:
6398     #   do whatever assignemnt or thing it likes with $_[0]
6399     #   if the option should not be passed on to remote, @rvalopts=()
6400     # or $how can be a scalar ref, meaning simply assign the value
6401 }
6402
6403 defvalopt '--since-version', '-v', '[^_]+|_', \$changes_since_version;
6404 defvalopt '--distro',        '-d', '.+',      \$idistro;
6405 defvalopt '',                '-k', '.+',      \$keyid;
6406 defvalopt '--existing-package','', '.*',      \$existing_package;
6407 defvalopt '--build-products-dir','','.*',     \$buildproductsdir;
6408 defvalopt '--clean',       '', $cleanmode_re, \$cleanmode;
6409 defvalopt '--package',   '-p',   $package_re, \$package;
6410 defvalopt '--quilt',     '', $quilt_modes_re, \$quilt_mode;
6411
6412 defvalopt '', '-C', '.+', sub {
6413     ($changesfile) = (@_);
6414     if ($changesfile =~ s#^(.*)/##) {
6415         $buildproductsdir = $1;
6416     }
6417 };
6418
6419 defvalopt '--initiator-tempdir','','.*', sub {
6420     ($initiator_tempdir) = (@_);
6421     $initiator_tempdir =~ m#^/# or
6422         badusage "--initiator-tempdir must be used specify an".
6423         " absolute, not relative, directory."
6424 };
6425
6426 sub defoptmodes ($@) {
6427     my ($varref, $cfgkey, $default, %optmap) = @_;
6428     my %permit;
6429     while (my ($opt,$val) = each %optmap) {
6430         $funcopts_long{$opt} = sub { $$varref = $val; };
6431         $permit{$val} = $val;
6432     }
6433     push @modeopt_cfgs, {
6434         Var => $varref,
6435         Key => $cfgkey,
6436         Default => $default,
6437         Vals => \%permit
6438     };
6439 }
6440
6441 defoptmodes \$dodep14tag, qw( dep14tag          want
6442                               --dep14tag        want
6443                               --no-dep14tag     no
6444                               --always-dep14tag always );
6445
6446 sub parseopts () {
6447     my $om;
6448
6449     if (defined $ENV{'DGIT_SSH'}) {
6450         @ssh = string_to_ssh $ENV{'DGIT_SSH'};
6451     } elsif (defined $ENV{'GIT_SSH'}) {
6452         @ssh = ($ENV{'GIT_SSH'});
6453     }
6454
6455     my $oi;
6456     my $val;
6457     my $valopt = sub {
6458         my ($what) = @_;
6459         @rvalopts = ($_);
6460         if (!defined $val) {
6461             badusage "$what needs a value" unless @ARGV;
6462             $val = shift @ARGV;
6463             push @rvalopts, $val;
6464         }
6465         badusage "bad value \`$val' for $what" unless
6466             $val =~ m/^$oi->{Re}$(?!\n)/s;
6467         my $how = $oi->{How};
6468         if (ref($how) eq 'SCALAR') {
6469             $$how = $val;
6470         } else {
6471             $how->($val);
6472         }
6473         push @ropts, @rvalopts;
6474     };
6475
6476     while (@ARGV) {
6477         last unless $ARGV[0] =~ m/^-/;
6478         $_ = shift @ARGV;
6479         last if m/^--?$/;
6480         if (m/^--/) {
6481             if (m/^--dry-run$/) {
6482                 push @ropts, $_;
6483                 $dryrun_level=2;
6484             } elsif (m/^--damp-run$/) {
6485                 push @ropts, $_;
6486                 $dryrun_level=1;
6487             } elsif (m/^--no-sign$/) {
6488                 push @ropts, $_;
6489                 $sign=0;
6490             } elsif (m/^--help$/) {
6491                 cmd_help();
6492             } elsif (m/^--version$/) {
6493                 cmd_version();
6494             } elsif (m/^--new$/) {
6495                 push @ropts, $_;
6496                 $new_package=1;
6497             } elsif (m/^--([-0-9a-z]+)=(.+)/s &&
6498                      ($om = $opts_opt_map{$1}) &&
6499                      length $om->[0]) {
6500                 push @ropts, $_;
6501                 $om->[0] = $2;
6502             } elsif (m/^--([-0-9a-z]+):(.*)/s &&
6503                      !$opts_opt_cmdonly{$1} &&
6504                      ($om = $opts_opt_map{$1})) {
6505                 push @ropts, $_;
6506                 push @$om, $2;
6507             } elsif (m/^--(gbp|dpm)$/s) {
6508                 push @ropts, "--quilt=$1";
6509                 $quilt_mode = $1;
6510             } elsif (m/^--ignore-dirty$/s) {
6511                 push @ropts, $_;
6512                 $ignoredirty = 1;
6513             } elsif (m/^--no-quilt-fixup$/s) {
6514                 push @ropts, $_;
6515                 $quilt_mode = 'nocheck';
6516             } elsif (m/^--no-rm-on-error$/s) {
6517                 push @ropts, $_;
6518                 $rmonerror = 0;
6519             } elsif (m/^--no-chase-dsc-distro$/s) {
6520                 push @ropts, $_;
6521                 $chase_dsc_distro = 0;
6522             } elsif (m/^--overwrite$/s) {
6523                 push @ropts, $_;
6524                 $overwrite_version = '';
6525             } elsif (m/^--overwrite=(.+)$/s) {
6526                 push @ropts, $_;
6527                 $overwrite_version = $1;
6528             } elsif (m/^--delayed=(\d+)$/s) {
6529                 push @ropts, $_;
6530                 push @dput, $_;
6531             } elsif (m/^--dgit-view-save=(.+)$/s) {
6532                 push @ropts, $_;
6533                 $split_brain_save = $1;
6534                 $split_brain_save =~ s#^(?!refs/)#refs/heads/#;
6535             } elsif (m/^--(no-)?rm-old-changes$/s) {
6536                 push @ropts, $_;
6537                 $rmchanges = !$1;
6538             } elsif (m/^--deliberately-($deliberately_re)$/s) {
6539                 push @ropts, $_;
6540                 push @deliberatelies, $&;
6541             } elsif (m/^--force-(.*)/ && defined $forceopts{$1}) {
6542                 push @ropts, $&;
6543                 $forceopts{$1} = 1;
6544                 $_='';
6545             } elsif (m/^--force-/) {
6546                 print STDERR
6547                     "$us: warning: ignoring unknown force option $_\n";
6548                 $_='';
6549             } elsif (m/^--dgit-tag-format=(old|new)$/s) {
6550                 # undocumented, for testing
6551                 push @ropts, $_;
6552                 $tagformat_want = [ $1, 'command line', 1 ];
6553                 # 1 menas overrides distro configuration
6554             } elsif (m/^--always-split-source-build$/s) {
6555                 # undocumented, for testing
6556                 push @ropts, $_;
6557                 $need_split_build_invocation = 1;
6558             } elsif (m/^--config-lookup-explode=(.+)$/s) {
6559                 # undocumented, for testing
6560                 push @ropts, $_;
6561                 $gitcfgs{cmdline}{$1} = 'CONFIG-LOOKUP-EXPLODE';
6562                 # ^ it's supposed to be an array ref
6563             } elsif (m/^(--[-0-9a-z]+)(=|$)/ && ($oi = $valopts_long{$1})) {
6564                 $val = $2 ? $' : undef; #';
6565                 $valopt->($oi->{Long});
6566             } elsif ($funcopts_long{$_}) {
6567                 push @ropts, $_;
6568                 $funcopts_long{$_}();
6569             } else {
6570                 badusage "unknown long option \`$_'";
6571             }
6572         } else {
6573             while (m/^-./s) {
6574                 if (s/^-n/-/) {
6575                     push @ropts, $&;
6576                     $dryrun_level=2;
6577                 } elsif (s/^-L/-/) {
6578                     push @ropts, $&;
6579                     $dryrun_level=1;
6580                 } elsif (s/^-h/-/) {
6581                     cmd_help();
6582                 } elsif (s/^-D/-/) {
6583                     push @ropts, $&;
6584                     $debuglevel++;
6585                     enabledebug();
6586                 } elsif (s/^-N/-/) {
6587                     push @ropts, $&;
6588                     $new_package=1;
6589                 } elsif (m/^-m/) {
6590                     push @ropts, $&;
6591                     push @changesopts, $_;
6592                     $_ = '';
6593                 } elsif (s/^-wn$//s) {
6594                     push @ropts, $&;
6595                     $cleanmode = 'none';
6596                 } elsif (s/^-wg$//s) {
6597                     push @ropts, $&;
6598                     $cleanmode = 'git';
6599                 } elsif (s/^-wgf$//s) {
6600                     push @ropts, $&;
6601                     $cleanmode = 'git-ff';
6602                 } elsif (s/^-wd$//s) {
6603                     push @ropts, $&;
6604                     $cleanmode = 'dpkg-source';
6605                 } elsif (s/^-wdd$//s) {
6606                     push @ropts, $&;
6607                     $cleanmode = 'dpkg-source-d';
6608                 } elsif (s/^-wc$//s) {
6609                     push @ropts, $&;
6610                     $cleanmode = 'check';
6611                 } elsif (s/^-c([^=]*)\=(.*)$//s) {
6612                     push @git, '-c', $&;
6613                     $gitcfgs{cmdline}{$1} = [ $2 ];
6614                 } elsif (s/^-c([^=]+)$//s) {
6615                     push @git, '-c', $&;
6616                     $gitcfgs{cmdline}{$1} = [ 'true' ];
6617                 } elsif (m/^-[a-zA-Z]/ && ($oi = $valopts_short{$&})) {
6618                     $val = $'; #';
6619                     $val = undef unless length $val;
6620                     $valopt->($oi->{Short});
6621                     $_ = '';
6622                 } else {
6623                     badusage "unknown short option \`$_'";
6624                 }
6625             }
6626         }
6627     }
6628 }
6629
6630 sub check_env_sanity () {
6631     my $blocked = new POSIX::SigSet;
6632     sigprocmask SIG_UNBLOCK, $blocked, $blocked or die $!;
6633
6634     eval {
6635         foreach my $name (qw(PIPE CHLD)) {
6636             my $signame = "SIG$name";
6637             my $signum = eval "POSIX::$signame" // die;
6638             ($SIG{$name} // 'DEFAULT') eq 'DEFAULT' or
6639                 die "$signame is set to something other than SIG_DFL\n";
6640             $blocked->ismember($signum) and
6641                 die "$signame is blocked\n";
6642         }
6643     };
6644     return unless $@;
6645     chomp $@;
6646     fail <<END;
6647 On entry to dgit, $@
6648 This is a bug produced by something in in your execution environment.
6649 Giving up.
6650 END
6651 }
6652
6653
6654 sub parseopts_late_defaults () {
6655     $isuite //= cfg("dgit-distro.$idistro.default-suite", 'RETURN-UNDEF')
6656         if defined $idistro;
6657     $isuite //= cfg('dgit.default.default-suite');
6658
6659     foreach my $k (keys %opts_opt_map) {
6660         my $om = $opts_opt_map{$k};
6661
6662         my $v = access_cfg("cmd-$k", 'RETURN-UNDEF');
6663         if (defined $v) {
6664             badcfg "cannot set command for $k"
6665                 unless length $om->[0];
6666             $om->[0] = $v;
6667         }
6668
6669         foreach my $c (access_cfg_cfgs("opts-$k")) {
6670             my @vl =
6671                 map { $_ ? @$_ : () }
6672                 map { $gitcfgs{$_}{$c} }
6673                 reverse @gitcfgsources;
6674             printdebug "CL $c ", (join " ", map { shellquote } @vl),
6675                 "\n" if $debuglevel >= 4;
6676             next unless @vl;
6677             badcfg "cannot configure options for $k"
6678                 if $opts_opt_cmdonly{$k};
6679             my $insertpos = $opts_cfg_insertpos{$k};
6680             @$om = ( @$om[0..$insertpos-1],
6681                      @vl,
6682                      @$om[$insertpos..$#$om] );
6683         }
6684     }
6685
6686     if (!defined $rmchanges) {
6687         local $access_forpush;
6688         $rmchanges = access_cfg_bool(0, 'rm-old-changes');
6689     }
6690
6691     if (!defined $quilt_mode) {
6692         local $access_forpush;
6693         $quilt_mode = cfg('dgit.force.quilt-mode', 'RETURN-UNDEF')
6694             // access_cfg('quilt-mode', 'RETURN-UNDEF')
6695             // 'linear';
6696         $quilt_mode =~ m/^($quilt_modes_re)$/
6697             or badcfg "unknown quilt-mode \`$quilt_mode'";
6698         $quilt_mode = $1;
6699     }
6700
6701     foreach my $moc (@modeopt_cfgs) {
6702         local $access_forpush;
6703         my $vr = $moc->{Var};
6704         next if defined $$vr;
6705         $$vr = access_cfg($moc->{Key}, 'RETURN-UNDEF') // $moc->{Default};
6706         my $v = $moc->{Vals}{$$vr};
6707         badcfg "unknown $moc->{Key} setting \`$$vr'" unless defined $v;
6708         $$vr = $v;
6709     }
6710
6711     $need_split_build_invocation ||= quiltmode_splitbrain();
6712
6713     if (!defined $cleanmode) {
6714         local $access_forpush;
6715         $cleanmode = access_cfg('clean-mode', 'RETURN-UNDEF');
6716         $cleanmode //= 'dpkg-source';
6717
6718         badcfg "unknown clean-mode \`$cleanmode'" unless
6719             $cleanmode =~ m/^($cleanmode_re)$(?!\n)/s;
6720     }
6721 }
6722
6723 if ($ENV{$fakeeditorenv}) {
6724     git_slurp_config();
6725     quilt_fixup_editor();
6726 }
6727
6728 parseopts();
6729 check_env_sanity();
6730 git_slurp_config();
6731
6732 print STDERR "DRY RUN ONLY\n" if $dryrun_level > 1;
6733 print STDERR "DAMP RUN - WILL MAKE LOCAL (UNSIGNED) CHANGES\n"
6734     if $dryrun_level == 1;
6735 if (!@ARGV) {
6736     print STDERR $helpmsg or die $!;
6737     exit 8;
6738 }
6739 my $cmd = shift @ARGV;
6740 $cmd =~ y/-/_/;
6741
6742 my $pre_fn = ${*::}{"pre_$cmd"};
6743 $pre_fn->() if $pre_fn;
6744
6745 my $fn = ${*::}{"cmd_$cmd"};
6746 $fn or badusage "unknown operation $cmd";
6747 $fn->();