dgit

   1 #!/usr/bin/perl -w
   2 # dgit
   3 # Integration between git and Debian-style archives
   4 #
   5 # Copyright (C)2013-2015 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
  38 use Debian::Dgit;
  39
  40 our $our_version = 'UNRELEASED'; ###substituted###
  41
  42 our @rpushprotovsn_support = qw(3 2);
  43 our $protovsn;
  44
  45 our $isuite = 'unstable';
  46 our $idistro;
  47 our $package;
  48 our @ropts;
  49
  50 our $sign = 1;
  51 our $dryrun_level = 0;
  52 our $changesfile;
  53 our $buildproductsdir = '..';
  54 our $new_package = 0;
  55 our $ignoredirty = 0;
  56 our $rmonerror = 1;
  57 our @deliberatelies;
  58 our %previously;
  59 our $existing_package = 'dpkg';
  60 our $cleanmode;
  61 our $changes_since_version;
  62 our $rmchanges;
  63 our $quilt_mode;
  64 our $quilt_modes_re = 'linear|smash|auto|nofix|nocheck|gbp|unapplied';
  65 our $we_are_responder;
  66 our $initiator_tempdir;
  67
  68 our %format_ok = map { $_=>1 } ("1.0","3.0 (native)","3.0 (quilt)");
  69
  70 our $suite_re = '[-+.0-9a-z]+';
  71 our $cleanmode_re = 'dpkg-source(?:-d)?|git|git-ff|check|none';
  72
  73 our (@git) = qw(git);
  74 our (@dget) = qw(dget);
  75 our (@curl) = qw(curl -f);
  76 our (@dput) = qw(dput);
  77 our (@debsign) = qw(debsign);
  78 our (@gpg) = qw(gpg);
  79 our (@sbuild) = qw(sbuild);
  80 our (@ssh) = 'ssh';
  81 our (@dgit) = qw(dgit);
  82 our (@dpkgbuildpackage) = qw(dpkg-buildpackage -i\.git/ -I.git);
  83 our (@dpkgsource) = qw(dpkg-source -i\.git/ -I.git);
  84 our (@dpkggenchanges) = qw(dpkg-genchanges);
  85 our (@mergechanges) = qw(mergechanges -f);
  86 our (@changesopts) = ('');
  87
  88 our %opts_opt_map = ('dget' => \@dget, # accept for compatibility
  89                      'curl' => \@curl,
  90                      'dput' => \@dput,
  91                      'debsign' => \@debsign,
  92                      'gpg' => \@gpg,
  93                      'sbuild' => \@sbuild,
  94                      'ssh' => \@ssh,
  95                      'dgit' => \@dgit,
  96                      'git' => \@git,
  97                      'dpkg-source' => \@dpkgsource,
  98                      'dpkg-buildpackage' => \@dpkgbuildpackage,
  99                      'dpkg-genchanges' => \@dpkggenchanges,
 100                      'ch' => \@changesopts,
 101                      'mergechanges' => \@mergechanges);
 102
 103 our %opts_opt_cmdonly = ('gpg' => 1, 'git' => 1);
 104 our %opts_cfg_insertpos = map {
 105     $_,
 106     scalar @{ $opts_opt_map{$_} }
 107 } keys %opts_opt_map;
 108
 109 sub finalise_opts_opts();
 110
 111 our $keyid;
 112
 113 autoflush STDOUT 1;
 114
 115 our $supplementary_message = '';
 116 our $need_split_build_invocation = 0;
 117
 118 END {
 119     local ($@, $?);
 120     print STDERR "! $_\n" foreach $supplementary_message =~ m/^.+$/mg;
 121 }
 122
 123 our $remotename = 'dgit';
 124 our @ourdscfield = qw(Dgit Vcs-Dgit-Master);
 125 our $csuite;
 126 our $instead_distro;
 127
 128 sub lbranch () { return "$branchprefix/$csuite"; }
 129 my $lbranch_re = '^refs/heads/'.$branchprefix.'/([^/.]+)$';
 130 sub lref () { return "refs/heads/".lbranch(); }
 131 sub lrref () { return "refs/remotes/$remotename/".server_branch($csuite); }
 132 sub rrref () { return server_ref($csuite); }
 133
 134 sub lrfetchrefs () { return "refs/dgit-fetch/$csuite"; }
 135
 136 sub stripepoch ($) {
 137     my ($vsn) = @_;
 138     $vsn =~ s/^\d+\://;
 139     return $vsn;
 140 }
 141
 142 sub srcfn ($$) {
 143     my ($vsn,$sfx) = @_;
 144     return "${package}_".(stripepoch $vsn).$sfx
 145 }
 146
 147 sub dscfn ($) {
 148     my ($vsn) = @_;
 149     return srcfn($vsn,".dsc");
 150 }
 151
 152 sub changespat ($;$) {
 153     my ($vsn, $arch) = @_;
 154     return "${package}_".(stripepoch $vsn)."_".($arch//'*').".changes";
 155 }
 156
 157 our $us = 'dgit';
 158 initdebug('');
 159
 160 our @end;
 161 END {
 162     local ($?);
 163     foreach my $f (@end) {
 164         eval { $f->(); };
 165         print STDERR "$us: cleanup: $@" if length $@;
 166     }
 167 };
 168
 169 sub badcfg { print STDERR "$us: invalid configuration: @_\n"; exit 12; }
 170
 171 sub no_such_package () {
 172     print STDERR "$us: package $package does not exist in suite $isuite\n";
 173     exit 4;
 174 }
 175
 176 sub fetchspec () {
 177     local $csuite = '*';
 178     return  "+".rrref().":".lrref();
 179 }
 180
 181 sub changedir ($) {
 182     my ($newdir) = @_;
 183     printdebug "CD $newdir\n";
 184     chdir $newdir or die "chdir: $newdir: $!";
 185 }
 186
 187 sub deliberately ($) {
 188     my ($enquiry) = @_;
 189     return !!grep { $_ eq "--deliberately-$enquiry" } @deliberatelies;
 190 }
 191
 192 sub deliberately_not_fast_forward () {
 193     foreach (qw(not-fast-forward fresh-repo)) {
 194         return 1 if deliberately($_) || deliberately("TEST-dgit-only-$_");
 195     }
 196 }
 197
 198 #---------- remote protocol support, common ----------
 199
 200 # remote push initiator/responder protocol:
 201 #  $ dgit remote-push-build-host <n-rargs> <rargs>... <push-args>...
 202 #  where <rargs> is <push-host-dir> <supported-proto-vsn>,... ...
 203 #  < dgit-remote-push-ready <actual-proto-vsn>
 204 #
 205 #  > file parsed-changelog
 206 #  [indicates that output of dpkg-parsechangelog follows]
 207 #  > data-block NBYTES
 208 #  > [NBYTES bytes of data (no newline)]
 209 #  [maybe some more blocks]
 210 #  > data-end
 211 #
 212 #  > file dsc
 213 #  [etc]
 214 #
 215 #  > file changes
 216 #  [etc]
 217 #
 218 #  > param head HEAD
 219 #
 220 #  > want signed-tag
 221 #  [indicates that signed tag is wanted]
 222 #  < data-block NBYTES
 223 #  < [NBYTES bytes of data (no newline)]
 224 #  [maybe some more blocks]
 225 #  < data-end
 226 #  < files-end
 227 #
 228 #  > want signed-dsc-changes
 229 #  < data-block NBYTES    [transfer of signed dsc]
 230 #  [etc]
 231 #  < data-block NBYTES    [transfer of signed changes]
 232 #  [etc]
 233 #  < files-end
 234 #
 235 #  > complete
 236
 237 our $i_child_pid;
 238
 239 sub i_child_report () {
 240     # Sees if our child has died, and reap it if so.  Returns a string
 241     # describing how it died if it failed, or undef otherwise.
 242     return undef unless $i_child_pid;
 243     my $got = waitpid $i_child_pid, WNOHANG;
 244     return undef if $got <= 0;
 245     die unless $got == $i_child_pid;
 246     $i_child_pid = undef;
 247     return undef unless $?;
 248     return "build host child ".waitstatusmsg();
 249 }
 250
 251 sub badproto ($$) {
 252     my ($fh, $m) = @_;
 253     fail "connection lost: $!" if $fh->error;
 254     fail "protocol violation; $m not expected";
 255 }
 256
 257 sub badproto_badread ($$) {
 258     my ($fh, $wh) = @_;
 259     fail "connection lost: $!" if $!;
 260     my $report = i_child_report();
 261     fail $report if defined $report;
 262     badproto $fh, "eof (reading $wh)";
 263 }
 264
 265 sub protocol_expect (&$) {
 266     my ($match, $fh) = @_;
 267     local $_;
 268     $_ = <$fh>;
 269     defined && chomp or badproto_badread $fh, "protocol message";
 270     if (wantarray) {
 271         my @r = &$match;
 272         return @r if @r;
 273     } else {
 274         my $r = &$match;
 275         return $r if $r;
 276     }
 277     badproto $fh, "\`$_'";
 278 }
 279
 280 sub protocol_send_file ($$) {
 281     my ($fh, $ourfn) = @_;
 282     open PF, "<", $ourfn or die "$ourfn: $!";
 283     for (;;) {
 284         my $d;
 285         my $got = read PF, $d, 65536;
 286         die "$ourfn: $!" unless defined $got;
 287         last if !$got;
 288         print $fh "data-block ".length($d)."\n" or die $!;
 289         print $fh $d or die $!;
 290     }
 291     PF->error and die "$ourfn $!";
 292     print $fh "data-end\n" or die $!;
 293     close PF;
 294 }
 295
 296 sub protocol_read_bytes ($$) {
 297     my ($fh, $nbytes) = @_;
 298     $nbytes =~ m/^[1-9]\d{0,5}$|^0$/ or badproto \*RO, "bad byte count";
 299     my $d;
 300     my $got = read $fh, $d, $nbytes;
 301     $got==$nbytes or badproto_badread $fh, "data block";
 302     return $d;
 303 }
 304
 305 sub protocol_receive_file ($$) {
 306     my ($fh, $ourfn) = @_;
 307     printdebug "() $ourfn\n";
 308     open PF, ">", $ourfn or die "$ourfn: $!";
 309     for (;;) {
 310         my ($y,$l) = protocol_expect {
 311             m/^data-block (.*)$/ ? (1,$1) :
 312             m/^data-end$/ ? (0,) :
 313             ();
 314         } $fh;
 315         last unless $y;
 316         my $d = protocol_read_bytes $fh, $l;
 317         print PF $d or die $!;
 318     }
 319     close PF or die $!;
 320 }
 321
 322 #---------- remote protocol support, responder ----------
 323
 324 sub responder_send_command ($) {
 325     my ($command) = @_;
 326     return unless $we_are_responder;
 327     # called even without $we_are_responder
 328     printdebug ">> $command\n";
 329     print PO $command, "\n" or die $!;
 330 }
 331
 332 sub responder_send_file ($$) {
 333     my ($keyword, $ourfn) = @_;
 334     return unless $we_are_responder;
 335     printdebug "]] $keyword $ourfn\n";
 336     responder_send_command "file $keyword";
 337     protocol_send_file \*PO, $ourfn;
 338 }
 339
 340 sub responder_receive_files ($@) {
 341     my ($keyword, @ourfns) = @_;
 342     die unless $we_are_responder;
 343     printdebug "[[ $keyword @ourfns\n";
 344     responder_send_command "want $keyword";
 345     foreach my $fn (@ourfns) {
 346         protocol_receive_file \*PI, $fn;
 347     }
 348     printdebug "[[\$\n";
 349     protocol_expect { m/^files-end$/ } \*PI;
 350 }
 351
 352 #---------- remote protocol support, initiator ----------
 353
 354 sub initiator_expect (&) {
 355     my ($match) = @_;
 356     protocol_expect { &$match } \*RO;
 357 }
 358
 359 #---------- end remote code ----------
 360
 361 sub progress {
 362     if ($we_are_responder) {
 363         my $m = join '', @_;
 364         responder_send_command "progress ".length($m) or die $!;
 365         print PO $m or die $!;
 366     } else {
 367         print @_, "\n";
 368     }
 369 }
 370
 371 our $ua;
 372
 373 sub url_get {
 374     if (!$ua) {
 375         $ua = LWP::UserAgent->new();
 376         $ua->env_proxy;
 377     }
 378     my $what = $_[$#_];
 379     progress "downloading $what...";
 380     my $r = $ua->get(@_) or die $!;
 381     return undef if $r->code == 404;
 382     $r->is_success or fail "failed to fetch $what: ".$r->status_line;
 383     return $r->decoded_content(charset => 'none');
 384 }
 385
 386 our ($dscdata,$dscurl,$dsc,$dsc_checked,$skew_warning_vsn);
 387
 388 sub runcmd {
 389     debugcmd "+",@_;
 390     $!=0; $?=0;
 391     failedcmd @_ if system @_;
 392 }
 393
 394 sub act_local () { return $dryrun_level <= 1; }
 395 sub act_scary () { return !$dryrun_level; }
 396
 397 sub printdone {
 398     if (!$dryrun_level) {
 399         progress "dgit ok: @_";
 400     } else {
 401         progress "would be ok: @_ (but dry run only)";
 402     }
 403 }
 404
 405 sub dryrun_report {
 406     printcmd(\*STDERR,$debugprefix."#",@_);
 407 }
 408
 409 sub runcmd_ordryrun {
 410     if (act_scary()) {
 411         runcmd @_;
 412     } else {
 413         dryrun_report @_;
 414     }
 415 }
 416
 417 sub runcmd_ordryrun_local {
 418     if (act_local()) {
 419         runcmd @_;
 420     } else {
 421         dryrun_report @_;
 422     }
 423 }
 424
 425 sub shell_cmd {
 426     my ($first_shell, @cmd) = @_;
 427     return qw(sh -ec), $first_shell.'; exec "$@"', 'x', @cmd;
 428 }
 429
 430 our $helpmsg = <<END;
 431 main usages:
 432   dgit [dgit-opts] clone [dgit-opts] package [suite] [./dir|/dir]
 433   dgit [dgit-opts] fetch|pull [dgit-opts] [suite]
 434   dgit [dgit-opts] build [dpkg-buildpackage-opts]
 435   dgit [dgit-opts] sbuild [sbuild-opts]
 436   dgit [dgit-opts] push [dgit-opts] [suite]
 437   dgit [dgit-opts] rpush build-host:build-dir ...
 438 important dgit options:
 439   -k<keyid>           sign tag and package with <keyid> instead of default
 440   --dry-run -n        do not change anything, but go through the motions
 441   --damp-run -L       like --dry-run but make local changes, without signing
 442   --new -N            allow introducing a new package
 443   --debug -D          increase debug level
 444   -c<name>=<value>    set git config option (used directly by dgit too)
 445 END
 446
 447 our $later_warning_msg = <<END;
 448 Perhaps the upload is stuck in incoming.  Using the version from git.
 449 END
 450
 451 sub badusage {
 452     print STDERR "$us: @_\n", $helpmsg or die $!;
 453     exit 8;
 454 }
 455
 456 sub nextarg {
 457     @ARGV or badusage "too few arguments";
 458     return scalar shift @ARGV;
 459 }
 460
 461 sub cmd_help () {
 462     print $helpmsg or die $!;
 463     exit 0;
 464 }
 465
 466 our $td = $ENV{DGIT_TEST_DUMMY_DIR} || "DGIT_TEST_DUMMY_DIR-unset";
 467
 468 our %defcfg = ('dgit.default.distro' => 'debian',
 469                'dgit.default.username' => '',
 470                'dgit.default.archive-query-default-component' => 'main',
 471                'dgit.default.ssh' => 'ssh',
 472                'dgit.default.archive-query' => 'madison:',
 473                'dgit.default.sshpsql-dbname' => 'service=projectb',
 474                'dgit-distro.debian.archive-query' => 'ftpmasterapi:',
 475                'dgit-distro.debian.git-check' => 'url',
 476                'dgit-distro.debian.git-check-suffix' => '/info/refs',
 477                'dgit-distro.debian.new-private-pushers' => 't',
 478                'dgit-distro.debian/push.git-url' => '',
 479                'dgit-distro.debian/push.git-host' => 'push.dgit.debian.org',
 480                'dgit-distro.debian/push.git-user-force' => 'dgit',
 481                'dgit-distro.debian/push.git-proto' => 'git+ssh://',
 482                'dgit-distro.debian/push.git-path' => '/dgit/debian/repos',
 483                'dgit-distro.debian/push.git-create' => 'true',
 484                'dgit-distro.debian/push.git-check' => 'ssh-cmd',
 485  'dgit-distro.debian.archive-query-url', 'https://api.ftp-master.debian.org/',
 486 # 'dgit-distro.debian.archive-query-tls-key',
 487 #    '/etc/ssl/certs/%HOST%.pem:/etc/dgit/%HOST%.pem',
 488 # ^ this does not work because curl is broken nowadays
 489 # Fixing #790093 properly will involve providing providing the key
 490 # in some pacagke and maybe updating these paths.
 491 #
 492 # 'dgit-distro.debian.archive-query-tls-curl-args',
 493 #   '--ca-path=/etc/ssl/ca-debian',
 494 # ^ this is a workaround but works (only) on DSA-administered machines
 495                'dgit-distro.debian.git-url' => 'https://git.dgit.debian.org',
 496                'dgit-distro.debian.git-url-suffix' => '',
 497                'dgit-distro.debian.upload-host' => 'ftp-master', # for dput
 498                'dgit-distro.debian.mirror' => 'http://ftp.debian.org/debian/',
 499  'dgit-distro.debian.backports-quirk' => '(squeeze)-backports*',
 500  'dgit-distro.debian-backports.mirror' => 'http://backports.debian.org/debian-backports/',
 501                'dgit-distro.ubuntu.git-check' => 'false',
 502  'dgit-distro.ubuntu.mirror' => 'http://archive.ubuntu.com/ubuntu',
 503                'dgit-distro.test-dummy.ssh' => "$td/ssh",
 504                'dgit-distro.test-dummy.username' => "alice",
 505                'dgit-distro.test-dummy.git-check' => "ssh-cmd",
 506                'dgit-distro.test-dummy.git-create' => "ssh-cmd",
 507                'dgit-distro.test-dummy.git-url' => "$td/git",
 508                'dgit-distro.test-dummy.git-host' => "git",
 509                'dgit-distro.test-dummy.git-path' => "$td/git",
 510                'dgit-distro.test-dummy.archive-query' => "ftpmasterapi:",
 511                'dgit-distro.test-dummy.archive-query-url' => "file://$td/aq/",
 512                'dgit-distro.test-dummy.mirror' => "file://$td/mirror/",
 513                'dgit-distro.test-dummy.upload-host' => 'test-dummy',
 514                );
 515
 516 our %gitcfg;
 517
 518 sub git_slurp_config () {
 519     local ($debuglevel) = $debuglevel-2;
 520     local $/="\0";
 521
 522     my @cmd = (@git, qw(config -z --get-regexp .*));
 523     debugcmd "|",@cmd;
 524
 525     open GITS, "-|", @cmd or failedcmd @cmd;
 526     while (<GITS>) {
 527         chomp or die;
 528         printdebug "=> ", (messagequote $_), "\n";
 529         m/\n/ or die "$_ ?";
 530         push @{ $gitcfg{$`} }, $'; #';
 531     }
 532     $!=0; $?=0;
 533     close GITS
 534         or ($!==0 && $?==256)
 535         or failedcmd @cmd;
 536 }
 537
 538 sub git_get_config ($) {
 539     my ($c) = @_;
 540     my $l = $gitcfg{$c};
 541     printdebug"C $c ".(defined $l ? messagequote "'$l'" : "undef")."\n"
 542         if $debuglevel >= 4;
 543     $l or return undef;
 544     @$l==1 or badcfg "multiple values for $c" if @$l > 1;
 545     return $l->[0];
 546 }
 547
 548 sub cfg {
 549     foreach my $c (@_) {
 550         return undef if $c =~ /RETURN-UNDEF/;
 551         my $v = git_get_config($c);
 552         return $v if defined $v;
 553         my $dv = $defcfg{$c};
 554         return $dv if defined $dv;
 555     }
 556     badcfg "need value for one of: @_\n".
 557         "$us: distro or suite appears not to be (properly) supported";
 558 }
 559
 560 sub access_basedistro () {
 561     if (defined $idistro) {
 562         return $idistro;
 563     } else {
 564         return cfg("dgit-suite.$isuite.distro",
 565                    "dgit.default.distro");
 566     }
 567 }
 568
 569 sub access_quirk () {
 570     # returns (quirk name, distro to use instead or undef, quirk-specific info)
 571     my $basedistro = access_basedistro();
 572     my $backports_quirk = cfg("dgit-distro.$basedistro.backports-quirk",
 573                               'RETURN-UNDEF');
 574     if (defined $backports_quirk) {
 575         my $re = $backports_quirk;
 576         $re =~ s/[^-0-9a-z_\%*()]/\\$&/ig;
 577         $re =~ s/\*/.*/g;
 578         $re =~ s/\%/([-0-9a-z_]+)/
 579             or $re =~ m/[()]/ or badcfg "backports-quirk needs \% or ( )";
 580         if ($isuite =~ m/^$re$/) {
 581             return ('backports',"$basedistro-backports",$1);
 582         }
 583     }
 584     return ('none',undef);
 585 }
 586
 587 our $access_forpush;
 588
 589 sub parse_cfg_bool ($$$) {
 590     my ($what,$def,$v) = @_;
 591     $v //= $def;
 592     return
 593         $v =~ m/^[ty1]/ ? 1 :
 594         $v =~ m/^[fn0]/ ? 0 :
 595         badcfg "$what needs t (true, y, 1) or f (false, n, 0) not \`$v'";
 596 }
 597
 598 sub access_forpush_config () {
 599     my $d = access_basedistro();
 600
 601     return 1 if
 602         $new_package &&
 603         parse_cfg_bool('new-private-pushers', 0,
 604                        cfg("dgit-distro.$d.new-private-pushers",
 605                            'RETURN-UNDEF'));
 606
 607     my $v = cfg("dgit-distro.$d.readonly", 'RETURN-UNDEF');
 608     $v //= 'a';
 609     return
 610         $v =~ m/^[ty1]/ ? 0 : # force readonly,    forpush = 0
 611         $v =~ m/^[fn0]/ ? 1 : # force nonreadonly, forpush = 1
 612         $v =~ m/^[a]/  ? '' : # auto,              forpush = ''
 613         badcfg "readonly needs t (true, y, 1) or f (false, n, 0) or a (auto)";
 614 }
 615
 616 sub access_forpush () {
 617     $access_forpush //= access_forpush_config();
 618     return $access_forpush;
 619 }
 620
 621 sub pushing () {
 622     die "$access_forpush ?" if ($access_forpush // 1) ne 1;
 623     badcfg "pushing but distro is configured readonly"
 624         if access_forpush_config() eq '0';
 625     $access_forpush = 1;
 626     $supplementary_message = <<'END' unless $we_are_responder;
 627 Push failed, before we got started.
 628 You can retry the push, after fixing the problem, if you like.
 629 END
 630     finalise_opts_opts();
 631 }
 632
 633 sub notpushing () {
 634     finalise_opts_opts();
 635 }
 636
 637 sub supplementary_message ($) {
 638     my ($msg) = @_;
 639     if (!$we_are_responder) {
 640         $supplementary_message = $msg;
 641         return;
 642     } elsif ($protovsn >= 3) {
 643         responder_send_command "supplementary-message ".length($msg)
 644             or die $!;
 645         print PO $msg or die $!;
 646     }
 647 }
 648
 649 sub access_distros () {
 650     # Returns list of distros to try, in order
 651     #
 652     # We want to try:
 653     #    0. `instead of' distro name(s) we have been pointed to
 654     #    1. the access_quirk distro, if any
 655     #    2a. the user's specified distro, or failing that  } basedistro
 656     #    2b. the distro calculated from the suite          }
 657     my @l = access_basedistro();
 658
 659     my (undef,$quirkdistro) = access_quirk();
 660     unshift @l, $quirkdistro;
 661     unshift @l, $instead_distro;
 662     @l = grep { defined } @l;
 663
 664     if (access_forpush()) {
 665         @l = map { ("$_/push", $_) } @l;
 666     }
 667     @l;
 668 }
 669
 670 sub access_cfg_cfgs (@) {
 671     my (@keys) = @_;
 672     my @cfgs;
 673     # The nesting of these loops determines the search order.  We put
 674     # the key loop on the outside so that we search all the distros
 675     # for each key, before going on to the next key.  That means that
 676     # if access_cfg is called with a more specific, and then a less
 677     # specific, key, an earlier distro can override the less specific
 678     # without necessarily overriding any more specific keys.  (If the
 679     # distro wants to override the more specific keys it can simply do
 680     # so; whereas if we did the loop the other way around, it would be
 681     # impossible to for an earlier distro to override a less specific
 682     # key but not the more specific ones without restating the unknown
 683     # values of the more specific keys.
 684     my @realkeys;
 685     my @rundef;
 686     # We have to deal with RETURN-UNDEF specially, so that we don't
 687     # terminate the search prematurely.
 688     foreach (@keys) {
 689         if (m/RETURN-UNDEF/) { push @rundef, $_; last; }
 690         push @realkeys, $_
 691     }
 692     foreach my $d (access_distros()) {
 693         push @cfgs, map { "dgit-distro.$d.$_" } @realkeys;
 694     }
 695     push @cfgs, map { "dgit.default.$_" } @realkeys;
 696     push @cfgs, @rundef;
 697     return @cfgs;
 698 }
 699
 700 sub access_cfg (@) {
 701     my (@keys) = @_;
 702     my (@cfgs) = access_cfg_cfgs(@keys);
 703     my $value = cfg(@cfgs);
 704     return $value;
 705 }
 706
 707 sub access_cfg_bool ($$) {
 708     my ($def, @keys) = @_;
 709     parse_cfg_bool($keys[0], $def, access_cfg(@keys, 'RETURN-UNDEF'));
 710 }
 711
 712 sub string_to_ssh ($) {
 713     my ($spec) = @_;
 714     if ($spec =~ m/\s/) {
 715         return qw(sh -ec), 'exec '.$spec.' "$@"', 'x';
 716     } else {
 717         return ($spec);
 718     }
 719 }
 720
 721 sub access_cfg_ssh () {
 722     my $gitssh = access_cfg('ssh', 'RETURN-UNDEF');
 723     if (!defined $gitssh) {
 724         return @ssh;
 725     } else {
 726         return string_to_ssh $gitssh;
 727     }
 728 }
 729
 730 sub access_runeinfo ($) {
 731     my ($info) = @_;
 732     return ": dgit ".access_basedistro()." $info ;";
 733 }
 734
 735 sub access_someuserhost ($) {
 736     my ($some) = @_;
 737     my $user = access_cfg("$some-user-force", 'RETURN-UNDEF');
 738     defined($user) && length($user) or
 739         $user = access_cfg("$some-user",'username');
 740     my $host = access_cfg("$some-host");
 741     return length($user) ? "$user\@$host" : $host;
 742 }
 743
 744 sub access_gituserhost () {
 745     return access_someuserhost('git');
 746 }
 747
 748 sub access_giturl (;$) {
 749     my ($optional) = @_;
 750     my $url = access_cfg('git-url','RETURN-UNDEF');
 751     my $suffix;
 752     if (!length $url) {
 753         my $proto = access_cfg('git-proto', 'RETURN-UNDEF');
 754         return undef unless defined $proto;
 755         $url =
 756             $proto.
 757             access_gituserhost().
 758             access_cfg('git-path');
 759     } else {
 760         $suffix = access_cfg('git-url-suffix','RETURN-UNDEF');
 761     }
 762     $suffix //= '.git';
 763     return "$url/$package$suffix";
 764 }
 765
 766 sub parsecontrolfh ($$;$) {
 767     my ($fh, $desc, $allowsigned) = @_;
 768     our $dpkgcontrolhash_noissigned;
 769     my $c;
 770     for (;;) {
 771         my %opts = ('name' => $desc);
 772         $opts{allow_pgp}= $allowsigned || !$dpkgcontrolhash_noissigned;
 773         $c = Dpkg::Control::Hash->new(%opts);
 774         $c->parse($fh,$desc) or die "parsing of $desc failed";
 775         last if $allowsigned;
 776         last if $dpkgcontrolhash_noissigned;
 777         my $issigned= $c->get_option('is_pgp_signed');
 778         if (!defined $issigned) {
 779             $dpkgcontrolhash_noissigned= 1;
 780             seek $fh, 0,0 or die "seek $desc: $!";
 781         } elsif ($issigned) {
 782             fail "control file $desc is (already) PGP-signed. ".
 783                 " Note that dgit push needs to modify the .dsc and then".
 784                 " do the signature itself";
 785         } else {
 786             last;
 787         }
 788     }
 789     return $c;
 790 }
 791
 792 sub parsecontrol {
 793     my ($file, $desc) = @_;
 794     my $fh = new IO::Handle;
 795     open $fh, '<', $file or die "$file: $!";
 796     my $c = parsecontrolfh($fh,$desc);
 797     $fh->error and die $!;
 798     close $fh;
 799     return $c;
 800 }
 801
 802 sub getfield ($$) {
 803     my ($dctrl,$field) = @_;
 804     my $v = $dctrl->{$field};
 805     return $v if defined $v;
 806     fail "missing field $field in ".$v->get_option('name');
 807 }
 808
 809 sub parsechangelog {
 810     my $c = Dpkg::Control::Hash->new();
 811     my $p = new IO::Handle;
 812     my @cmd = (qw(dpkg-parsechangelog), @_);
 813     open $p, '-|', @cmd or die $!;
 814     $c->parse($p);
 815     $?=0; $!=0; close $p or failedcmd @cmd;
 816     return $c;
 817 }
 818
 819 sub must_getcwd () {
 820     my $d = getcwd();
 821     defined $d or fail "getcwd failed: $!";
 822     return $d;
 823 }
 824
 825 our %rmad;
 826
 827 sub archive_query ($) {
 828     my ($method) = @_;
 829     my $query = access_cfg('archive-query','RETURN-UNDEF');
 830     $query =~ s/^(\w+):// or badcfg "invalid archive-query method \`$query'";
 831     my $proto = $1;
 832     my $data = $'; #';
 833     { no strict qw(refs); &{"${method}_${proto}"}($proto,$data); }
 834 }
 835
 836 sub pool_dsc_subpath ($$) {
 837     my ($vsn,$component) = @_; # $package is implict arg
 838     my $prefix = substr($package, 0, $package =~ m/^l/ ? 4 : 1);
 839     return "/pool/$component/$prefix/$package/".dscfn($vsn);
 840 }
 841
 842 #---------- `ftpmasterapi' archive query method (nascent) ----------
 843
 844 sub archive_api_query_cmd ($) {
 845     my ($subpath) = @_;
 846     my @cmd = qw(curl -sS);
 847     my $url = access_cfg('archive-query-url');
 848     if ($url =~ m#^https://([-.0-9a-z]+)/#) {
 849         my $host = $1;
 850         my $keys = access_cfg('archive-query-tls-key','RETURN-UNDEF') //'';
 851         foreach my $key (split /\:/, $keys) {
 852             $key =~ s/\%HOST\%/$host/g;
 853             if (!stat $key) {
 854                 fail "for $url: stat $key: $!" unless $!==ENOENT;
 855                 next;
 856             }
 857             fail "config requested specific TLS key but do not know".
 858                 " how to get curl to use exactly that EE key ($key)";
 859 #           push @cmd, "--cacert", $key, "--capath", "/dev/enoent";
 860 #           # Sadly the above line does not work because of changes
 861 #           # to gnutls.   The real fix for #790093 may involve
 862 #           # new curl options.
 863             last;
 864         }
 865         # Fixing #790093 properly will involve providing a value
 866         # for this on clients.
 867         my $kargs = access_cfg('archive-query-tls-curl-ca-args','RETURN-UNDEF');
 868         push @cmd, split / /, $kargs if defined $kargs;
 869     }
 870     push @cmd, $url.$subpath;
 871     return @cmd;
 872 }
 873
 874 sub api_query ($$) {
 875     use JSON;
 876     my ($data, $subpath) = @_;
 877     badcfg "ftpmasterapi archive query method takes no data part"
 878         if length $data;
 879     my @cmd = archive_api_query_cmd($subpath);
 880     my $json = cmdoutput @cmd;
 881     return decode_json($json);
 882 }
 883
 884 sub canonicalise_suite_ftpmasterapi () {
 885     my ($proto,$data) = @_;
 886     my $suites = api_query($data, 'suites');
 887     my @matched;
 888     foreach my $entry (@$suites) {
 889         next unless grep {
 890             my $v = $entry->{$_};
 891             defined $v && $v eq $isuite;
 892         } qw(codename name);
 893         push @matched, $entry;
 894     }
 895     fail "unknown suite $isuite" unless @matched;
 896     my $cn;
 897     eval {
 898         @matched==1 or die "multiple matches for suite $isuite\n";
 899         $cn = "$matched[0]{codename}";
 900         defined $cn or die "suite $isuite info has no codename\n";
 901         $cn =~ m/^$suite_re$/ or die "suite $isuite maps to bad codename\n";
 902     };
 903     die "bad ftpmaster api response: $@\n".Dumper(\@matched)
 904         if length $@;
 905     return $cn;
 906 }
 907
 908 sub archive_query_ftpmasterapi () {
 909     my ($proto,$data) = @_;
 910     my $info = api_query($data, "dsc_in_suite/$isuite/$package");
 911     my @rows;
 912     my $digester = Digest::SHA->new(256);
 913     foreach my $entry (@$info) {
 914         eval {
 915             my $vsn = "$entry->{version}";
 916             my ($ok,$msg) = version_check $vsn;
 917             die "bad version: $msg\n" unless $ok;
 918             my $component = "$entry->{component}";
 919             $component =~ m/^$component_re$/ or die "bad component";
 920             my $filename = "$entry->{filename}";
 921             $filename && $filename !~ m#[^-+:._~0-9a-zA-Z/]|^[/.]|/[/.]#
 922                 or die "bad filename";
 923             my $sha256sum = "$entry->{sha256sum}";
 924             $sha256sum =~ m/^[0-9a-f]+$/ or die "bad sha256sum";
 925             push @rows, [ $vsn, "/pool/$component/$filename",
 926                           $digester, $sha256sum ];
 927         };
 928         die "bad ftpmaster api response: $@\n".Dumper($entry)
 929             if length $@;
 930     }
 931     @rows = sort { -version_compare($a->[0],$b->[0]) } @rows;
 932     return @rows;
 933 }
 934
 935 #---------- `madison' archive query method ----------
 936
 937 sub archive_query_madison {
 938     return map { [ @$_[0..1] ] } madison_get_parse(@_);
 939 }
 940
 941 sub madison_get_parse {
 942     my ($proto,$data) = @_;
 943     die unless $proto eq 'madison';
 944     if (!length $data) {
 945         $data= access_cfg('madison-distro','RETURN-UNDEF');
 946         $data //= access_basedistro();
 947     }
 948     $rmad{$proto,$data,$package} ||= cmdoutput
 949         qw(rmadison -asource),"-s$isuite","-u$data",$package;
 950     my $rmad = $rmad{$proto,$data,$package};
 951
 952     my @out;
 953     foreach my $l (split /\n/, $rmad) {
 954         $l =~ m{^ \s*( [^ \t|]+ )\s* \|
 955                   \s*( [^ \t|]+ )\s* \|
 956                   \s*( [^ \t|/]+ )(?:/([^ \t|/]+))? \s* \|
 957                   \s*( [^ \t|]+ )\s* }x or die "$rmad ?";
 958         $1 eq $package or die "$rmad $package ?";
 959         my $vsn = $2;
 960         my $newsuite = $3;
 961         my $component;
 962         if (defined $4) {
 963             $component = $4;
 964         } else {
 965             $component = access_cfg('archive-query-default-component');
 966         }
 967         $5 eq 'source' or die "$rmad ?";
 968         push @out, [$vsn,pool_dsc_subpath($vsn,$component),$newsuite];
 969     }
 970     return sort { -version_compare($a->[0],$b->[0]); } @out;
 971 }
 972
 973 sub canonicalise_suite_madison {
 974     # madison canonicalises for us
 975     my @r = madison_get_parse(@_);
 976     @r or fail
 977         "unable to canonicalise suite using package $package".
 978         " which does not appear to exist in suite $isuite;".
 979         " --existing-package may help";
 980     return $r[0][2];
 981 }
 982
 983 #---------- `sshpsql' archive query method ----------
 984
 985 sub sshpsql ($$$) {
 986     my ($data,$runeinfo,$sql) = @_;
 987     if (!length $data) {
 988         $data= access_someuserhost('sshpsql').':'.
 989             access_cfg('sshpsql-dbname');
 990     }
 991     $data =~ m/:/ or badcfg "invalid sshpsql method string \`$data'";
 992     my ($userhost,$dbname) = ($`,$'); #';
 993     my @rows;
 994     my @cmd = (access_cfg_ssh, $userhost,
 995                access_runeinfo("ssh-psql $runeinfo").
 996                " export LC_MESSAGES=C; export LC_CTYPE=C;".
 997                " ".shellquote qw(psql -A), $dbname, qw(-c), $sql);
 998     debugcmd "|",@cmd;
 999     open P, "-|", @cmd or die $!;
1000     while (<P>) {
1001         chomp or die;
1002         printdebug(">|$_|\n");
1003         push @rows, $_;
1004     }
1005     $!=0; $?=0; close P or failedcmd @cmd;
1006     @rows or die;
1007     my $nrows = pop @rows;
1008     $nrows =~ s/^\((\d+) rows?\)$/$1/ or die "$nrows ?";
1009     @rows == $nrows+1 or die "$nrows ".(scalar @rows)." ?";
1010     @rows = map { [ split /\|/, $_ ] } @rows;
1011     my $ncols = scalar @{ shift @rows };
1012     die if grep { scalar @$_ != $ncols } @rows;
1013     return @rows;
1014 }
1015
1016 sub sql_injection_check {
1017     foreach (@_) { die "$_ $& ?" if m{[^-+=:_.,/0-9a-zA-Z]}; }
1018 }
1019
1020 sub archive_query_sshpsql ($$) {
1021     my ($proto,$data) = @_;
1022     sql_injection_check $isuite, $package;
1023     my @rows = sshpsql($data, "archive-query $isuite $package", <<END);
1024         SELECT source.version, component.name, files.filename, files.sha256sum
1025           FROM source
1026           JOIN src_associations ON source.id = src_associations.source
1027           JOIN suite ON suite.id = src_associations.suite
1028           JOIN dsc_files ON dsc_files.source = source.id
1029           JOIN files_archive_map ON files_archive_map.file_id = dsc_files.file
1030           JOIN component ON component.id = files_archive_map.component_id
1031           JOIN files ON files.id = dsc_files.file
1032          WHERE ( suite.suite_name='$isuite' OR suite.codename='$isuite' )
1033            AND source.source='$package'
1034            AND files.filename LIKE '%.dsc';
1035 END
1036     @rows = sort { -version_compare($a->[0],$b->[0]) } @rows;
1037     my $digester = Digest::SHA->new(256);
1038     @rows = map {
1039         my ($vsn,$component,$filename,$sha256sum) = @$_;
1040         [ $vsn, "/pool/$component/$filename",$digester,$sha256sum ];
1041     } @rows;
1042     return @rows;
1043 }
1044
1045 sub canonicalise_suite_sshpsql ($$) {
1046     my ($proto,$data) = @_;
1047     sql_injection_check $isuite;
1048     my @rows = sshpsql($data, "canonicalise-suite $isuite", <<END);
1049         SELECT suite.codename
1050           FROM suite where suite_name='$isuite' or codename='$isuite';
1051 END
1052     @rows = map { $_->[0] } @rows;
1053     fail "unknown suite $isuite" unless @rows;
1054     die "ambiguous $isuite: @rows ?" if @rows>1;
1055     return $rows[0];
1056 }
1057
1058 #---------- `dummycat' archive query method ----------
1059
1060 sub canonicalise_suite_dummycat ($$) {
1061     my ($proto,$data) = @_;
1062     my $dpath = "$data/suite.$isuite";
1063     if (!open C, "<", $dpath) {
1064         $!==ENOENT or die "$dpath: $!";
1065         printdebug "dummycat canonicalise_suite $isuite $dpath ENOENT\n";
1066         return $isuite;
1067     }
1068     $!=0; $_ = <C>;
1069     chomp or die "$dpath: $!";
1070     close C;
1071     printdebug "dummycat canonicalise_suite $isuite $dpath = $_\n";
1072     return $_;
1073 }
1074
1075 sub archive_query_dummycat ($$) {
1076     my ($proto,$data) = @_;
1077     canonicalise_suite();
1078     my $dpath = "$data/package.$csuite.$package";
1079     if (!open C, "<", $dpath) {
1080         $!==ENOENT or die "$dpath: $!";
1081         printdebug "dummycat query $csuite $package $dpath ENOENT\n";
1082         return ();
1083     }
1084     my @rows;
1085     while (<C>) {
1086         next if m/^\#/;
1087         next unless m/\S/;
1088         die unless chomp;
1089         printdebug "dummycat query $csuite $package $dpath | $_\n";
1090         my @row = split /\s+/, $_;
1091         @row==2 or die "$dpath: $_ ?";
1092         push @rows, \@row;
1093     }
1094     C->error and die "$dpath: $!";
1095     close C;
1096     return sort { -version_compare($a->[0],$b->[0]); } @rows;
1097 }
1098
1099 #---------- archive query entrypoints and rest of program ----------
1100
1101 sub canonicalise_suite () {
1102     return if defined $csuite;
1103     fail "cannot operate on $isuite suite" if $isuite eq 'UNRELEASED';
1104     $csuite = archive_query('canonicalise_suite');
1105     if ($isuite ne $csuite) {
1106         progress "canonical suite name for $isuite is $csuite";
1107     }
1108 }
1109
1110 sub get_archive_dsc () {
1111     canonicalise_suite();
1112     my @vsns = archive_query('archive_query');
1113     foreach my $vinfo (@vsns) {
1114         my ($vsn,$subpath,$digester,$digest) = @$vinfo;
1115         $dscurl = access_cfg('mirror').$subpath;
1116         $dscdata = url_get($dscurl);
1117         if (!$dscdata) {
1118             $skew_warning_vsn = $vsn if !defined $skew_warning_vsn;
1119             next;
1120         }
1121         if ($digester) {
1122             $digester->reset();
1123             $digester->add($dscdata);
1124             my $got = $digester->hexdigest();
1125             $got eq $digest or
1126                 fail "$dscurl has hash $got but".
1127                     " archive told us to expect $digest";
1128         }
1129         my $dscfh = new IO::File \$dscdata, '<' or die $!;
1130         printdebug Dumper($dscdata) if $debuglevel>1;
1131         $dsc = parsecontrolfh($dscfh,$dscurl,1);
1132         printdebug Dumper($dsc) if $debuglevel>1;
1133         my $fmt = getfield $dsc, 'Format';
1134         fail "unsupported source format $fmt, sorry" unless $format_ok{$fmt};
1135         $dsc_checked = !!$digester;
1136         return;
1137     }
1138     $dsc = undef;
1139 }
1140
1141 sub check_for_git ();
1142 sub check_for_git () {
1143     # returns 0 or 1
1144     my $how = access_cfg('git-check');
1145     if ($how eq 'ssh-cmd') {
1146         my @cmd =
1147             (access_cfg_ssh, access_gituserhost(),
1148              access_runeinfo("git-check $package").
1149              " set -e; cd ".access_cfg('git-path').";".
1150              " if test -d $package.git; then echo 1; else echo 0; fi");
1151         my $r= cmdoutput @cmd;
1152         if ($r =~ m/^divert (\w+)$/) {
1153             my $divert=$1;
1154             my ($usedistro,) = access_distros();
1155             # NB that if we are pushing, $usedistro will be $distro/push
1156             $instead_distro= cfg("dgit-distro.$usedistro.diverts.$divert");
1157             $instead_distro =~ s{^/}{ access_basedistro()."/" }e;
1158             progress "diverting to $divert (using config for $instead_distro)";
1159             return check_for_git();
1160         }
1161         failedcmd @cmd unless $r =~ m/^[01]$/;
1162         return $r+0;
1163     } elsif ($how eq 'url') {
1164         my $prefix = access_cfg('git-check-url','git-url');
1165         my $suffix = access_cfg('git-check-suffix','git-suffix',
1166                                 'RETURN-UNDEF') // '.git';
1167         my $url = "$prefix/$package$suffix";
1168         my @cmd = (qw(curl -sS -I), $url);
1169         my $result = cmdoutput @cmd;
1170         $result =~ s/^\S+ 200 .*\n\r?\n//;
1171         # curl -sS -I with https_proxy prints
1172         # HTTP/1.0 200 Connection established
1173         $result =~ m/^\S+ (404|200) /s or
1174             fail "unexpected results from git check query - ".
1175                 Dumper($prefix, $result);
1176         my $code = $1;
1177         if ($code eq '404') {
1178             return 0;
1179         } elsif ($code eq '200') {
1180             return 1;
1181         } else {
1182             die;
1183         }
1184     } elsif ($how eq 'true') {
1185         return 1;
1186     } elsif ($how eq 'false') {
1187         return 0;
1188     } else {
1189         badcfg "unknown git-check \`$how'";
1190     }
1191 }
1192
1193 sub create_remote_git_repo () {
1194     my $how = access_cfg('git-create');
1195     if ($how eq 'ssh-cmd') {
1196         runcmd_ordryrun
1197             (access_cfg_ssh, access_gituserhost(),
1198              access_runeinfo("git-create $package").
1199              "set -e; cd ".access_cfg('git-path').";".
1200              " cp -a _template $package.git");
1201     } elsif ($how eq 'true') {
1202         # nothing to do
1203     } else {
1204         badcfg "unknown git-create \`$how'";
1205     }
1206 }
1207
1208 our ($dsc_hash,$lastpush_hash);
1209
1210 our $ud = '.git/dgit/unpack';
1211
1212 sub prep_ud (;$) {
1213     my ($d) = @_;
1214     $d //= $ud;
1215     rmtree($d);
1216     mkpath '.git/dgit';
1217     mkdir $d or die $!;
1218 }
1219
1220 sub mktree_in_ud_here () {
1221     runcmd qw(git init -q);
1222     rmtree('.git/objects');
1223     symlink '../../../../objects','.git/objects' or die $!;
1224 }
1225
1226 sub git_write_tree () {
1227     my $tree = cmdoutput @git, qw(write-tree);
1228     $tree =~ m/^\w+$/ or die "$tree ?";
1229     return $tree;
1230 }
1231
1232 sub remove_stray_gits () {
1233     my @gitscmd = qw(find -name .git -prune -print0);
1234     debugcmd "|",@gitscmd;
1235     open GITS, "-|", @gitscmd or failedcmd @gitscmd;
1236     {
1237         local $/="\0";
1238         while (<GITS>) {
1239             chomp or die;
1240             print STDERR "$us: warning: removing from source package: ",
1241                 (messagequote $_), "\n";
1242             rmtree $_;
1243         }
1244     }
1245     $!=0; $?=0; close GITS or failedcmd @gitscmd;
1246 }
1247
1248 sub mktree_in_ud_from_only_subdir () {
1249     # changes into the subdir
1250     my (@dirs) = <*/.>;
1251     die unless @dirs==1;
1252     $dirs[0] =~ m#^([^/]+)/\.$# or die;
1253     my $dir = $1;
1254     changedir $dir;
1255
1256     remove_stray_gits();
1257     mktree_in_ud_here();
1258     my ($format, $fopts) = get_source_format();
1259     if (madformat($format)) {
1260         rmtree '.pc';
1261     }
1262     runcmd @git, qw(add -Af);
1263     my $tree=git_write_tree();
1264     return ($tree,$dir);
1265 }
1266
1267 sub dsc_files_info () {
1268     foreach my $csumi (['Checksums-Sha256','Digest::SHA', 'new(256)'],
1269                        ['Checksums-Sha1',  'Digest::SHA', 'new(1)'],
1270                        ['Files',           'Digest::MD5', 'new()']) {
1271         my ($fname, $module, $method) = @$csumi;
1272         my $field = $dsc->{$fname};
1273         next unless defined $field;
1274         eval "use $module; 1;" or die $@;
1275         my @out;
1276         foreach (split /\n/, $field) {
1277             next unless m/\S/;
1278             m/^(\w+) (\d+) (\S+)$/ or
1279                 fail "could not parse .dsc $fname line \`$_'";
1280             my $digester = eval "$module"."->$method;" or die $@;
1281             push @out, {
1282                 Hash => $1,
1283                 Bytes => $2,
1284                 Filename => $3,
1285                 Digester => $digester,
1286             };
1287         }
1288         return @out;
1289     }
1290     fail "missing any supported Checksums-* or Files field in ".
1291         $dsc->get_option('name');
1292 }
1293
1294 sub dsc_files () {
1295     map { $_->{Filename} } dsc_files_info();
1296 }
1297
1298 sub is_orig_file ($;$) {
1299     local ($_) = $_[0];
1300     my $base = $_[1];
1301     m/\.orig(?:-\w+)?\.tar\.\w+$/ or return 0;
1302     defined $base or return 1;
1303     return $` eq $base;
1304 }
1305
1306 sub make_commit ($) {
1307     my ($file) = @_;
1308     return cmdoutput @git, qw(hash-object -w -t commit), $file;
1309 }
1310
1311 sub clogp_authline ($) {
1312     my ($clogp) = @_;
1313     my $author = getfield $clogp, 'Maintainer';
1314     $author =~ s#,.*##ms;
1315     my $date = cmdoutput qw(date), '+%s %z', qw(-d), getfield($clogp,'Date');
1316     my $authline = "$author $date";
1317     $authline =~ m/^[^<>]+ \<\S+\> \d+ [-+]\d+$/ or
1318         fail "unexpected commit author line format \`$authline'".
1319         " (was generated from changelog Maintainer field)";
1320     return $authline;
1321 }
1322
1323 sub vendor_patches_distro ($$) {
1324     my ($checkdistro, $what) = @_;
1325     return unless defined $checkdistro;
1326
1327     my $series = "debian/patches/\L$checkdistro\E.series";
1328     printdebug "checking for vendor-specific $series ($what)\n";
1329
1330     if (!open SERIES, "<", $series) {
1331         die "$series $!" unless $!==ENOENT;
1332         return;
1333     }
1334     while (<SERIES>) {
1335         next unless m/\S/;
1336         next if m/^\s+\#/;
1337
1338         print STDERR <<END;
1339
1340 Unfortunately, this source package uses a feature of dpkg-source where
1341 the same source package unpacks to different source code on different
1342 distros.  dgit cannot safely operate on such packages on affected
1343 distros, because the meaning of source packages is not stable.
1344
1345 Please ask the distro/maintainer to remove the distro-specific series
1346 files and use a different technique (if necessary, uploading actually
1347 different packages, if different distros are supposed to have
1348 different code).
1349
1350 END
1351         fail "Found active distro-specific series file for".
1352             " $checkdistro ($what): $series, cannot continue";
1353     }
1354     die "$series $!" if SERIES->error;
1355     close SERIES;
1356 }
1357
1358 sub check_for_vendor_patches () {
1359     # This dpkg-source feature doesn't seem to be documented anywhere!
1360     # But it can be found in the changelog (reformatted):
1361
1362     #   commit  4fa01b70df1dc4458daee306cfa1f987b69da58c
1363     #   Author: Raphael Hertzog <hertzog@debian.org>
1364     #   Date: Sun  Oct  3  09:36:48  2010 +0200
1365
1366     #   dpkg-source: correctly create .pc/.quilt_series with alternate
1367     #   series files
1368     #
1369     #   If you have debian/patches/ubuntu.series and you were
1370     #   unpacking the source package on ubuntu, quilt was still
1371     #   directed to debian/patches/series instead of
1372     #   debian/patches/ubuntu.series.
1373     #
1374     #   debian/changelog                        |    3 +++
1375     #   scripts/Dpkg/Source/Package/V3/quilt.pm |    4 +++-
1376     #   2 files changed, 6 insertions(+), 1 deletion(-)
1377
1378     use Dpkg::Vendor;
1379     vendor_patches_distro($ENV{DEB_VENDOR}, "DEB_VENDOR");
1380     vendor_patches_distro(Dpkg::Vendor::get_current_vendor(),
1381                          "Dpkg::Vendor \`current vendor'");
1382     vendor_patches_distro(access_basedistro(),
1383                           "distro being accessed");
1384 }
1385
1386 sub generate_commit_from_dsc () {
1387     prep_ud();
1388     changedir $ud;
1389
1390     foreach my $fi (dsc_files_info()) {
1391         my $f = $fi->{Filename};
1392         die "$f ?" if $f =~ m#/|^\.|\.dsc$|\.tmp$#;
1393
1394         link_ltarget "../../../$f", $f
1395             or $!==&ENOENT
1396             or die "$f $!";
1397
1398         complete_file_from_dsc('.', $fi)
1399             or next;
1400
1401         if (is_orig_file($f)) {
1402             link $f, "../../../../$f"
1403                 or $!==&EEXIST
1404                 or die "$f $!";
1405         }
1406     }
1407
1408     my $dscfn = "$package.dsc";
1409
1410     open D, ">", $dscfn or die "$dscfn: $!";
1411     print D $dscdata or die "$dscfn: $!";
1412     close D or die "$dscfn: $!";
1413     my @cmd = qw(dpkg-source);
1414     push @cmd, '--no-check' if $dsc_checked;
1415     push @cmd, qw(-x --), $dscfn;
1416     runcmd @cmd;
1417
1418     my ($tree,$dir) = mktree_in_ud_from_only_subdir();
1419     check_for_vendor_patches() if madformat($dsc->{format});
1420     runcmd qw(sh -ec), 'dpkg-parsechangelog >../changelog.tmp';
1421     my $clogp = parsecontrol('../changelog.tmp',"commit's changelog");
1422     my $authline = clogp_authline $clogp;
1423     my $changes = getfield $clogp, 'Changes';
1424     open C, ">../commit.tmp" or die $!;
1425     print C <<END or die $!;
1426 tree $tree
1427 author $authline
1428 committer $authline
1429
1430 $changes
1431
1432 # imported from the archive
1433 END
1434     close C or die $!;
1435     my $outputhash = make_commit qw(../commit.tmp);
1436     my $cversion = getfield $clogp, 'Version';
1437     progress "synthesised git commit from .dsc $cversion";
1438     if ($lastpush_hash) {
1439         runcmd @git, qw(reset --hard), $lastpush_hash;
1440         runcmd qw(sh -ec), 'dpkg-parsechangelog >>../changelogold.tmp';
1441         my $oldclogp = parsecontrol('../changelogold.tmp','previous changelog');
1442         my $oversion = getfield $oldclogp, 'Version';
1443         my $vcmp =
1444             version_compare($oversion, $cversion);
1445         if ($vcmp < 0) {
1446             # git upload/ is earlier vsn than archive, use archive
1447             open C, ">../commit2.tmp" or die $!;
1448             print C <<END or die $!;
1449 tree $tree
1450 parent $lastpush_hash
1451 parent $outputhash
1452 author $authline
1453 committer $authline
1454
1455 Record $package ($cversion) in archive suite $csuite
1456 END
1457             $outputhash = make_commit qw(../commit2.tmp);
1458         } elsif ($vcmp > 0) {
1459             print STDERR <<END or die $!;
1460
1461 Version actually in archive:    $cversion (older)
1462 Last allegedly pushed/uploaded: $oversion (newer or same)
1463 $later_warning_msg
1464 END
1465             $outputhash = $lastpush_hash;
1466         } else {
1467             $outputhash = $lastpush_hash;
1468         }
1469     }
1470     changedir '../../../..';
1471     runcmd @git, qw(update-ref -m),"dgit fetch import $cversion",
1472             'DGIT_ARCHIVE', $outputhash;
1473     cmdoutput @git, qw(log -n2), $outputhash;
1474     # ... gives git a chance to complain if our commit is malformed
1475     rmtree($ud);
1476     return $outputhash;
1477 }
1478
1479 sub complete_file_from_dsc ($$) {
1480     our ($dstdir, $fi) = @_;
1481     # Ensures that we have, in $dir, the file $fi, with the correct
1482     # contents.  (Downloading it from alongside $dscurl if necessary.)
1483
1484     my $f = $fi->{Filename};
1485     my $tf = "$dstdir/$f";
1486     my $downloaded = 0;
1487
1488     if (stat_exists $tf) {
1489         progress "using existing $f";
1490     } else {
1491         my $furl = $dscurl;
1492         $furl =~ s{/[^/]+$}{};
1493         $furl .= "/$f";
1494         die "$f ?" unless $f =~ m/^\Q${package}\E_/;
1495         die "$f ?" if $f =~ m#/#;
1496         runcmd_ordryrun_local @curl,qw(-o),$tf,'--',"$furl";
1497         return 0 if !act_local();
1498         $downloaded = 1;
1499     }
1500
1501     open F, "<", "$tf" or die "$tf: $!";
1502     $fi->{Digester}->reset();
1503     $fi->{Digester}->addfile(*F);
1504     F->error and die $!;
1505     my $got = $fi->{Digester}->hexdigest();
1506     $got eq $fi->{Hash} or
1507         fail "file $f has hash $got but .dsc".
1508             " demands hash $fi->{Hash} ".
1509             ($downloaded ? "(got wrong file from archive!)"
1510              : "(perhaps you should delete this file?)");
1511
1512     return 1;
1513 }
1514
1515 sub ensure_we_have_orig () {
1516     foreach my $fi (dsc_files_info()) {
1517         my $f = $fi->{Filename};
1518         next unless is_orig_file($f);
1519         complete_file_from_dsc('..', $fi)
1520             or next;
1521     }
1522 }
1523
1524 sub git_fetch_us () {
1525     my @specs = (fetchspec());
1526     push @specs,
1527         map { "+refs/$_/*:".lrfetchrefs."/$_/*" }
1528         qw(tags heads);
1529     runcmd_ordryrun_local @git, qw(fetch -p -n -q), access_giturl(), @specs;
1530
1531     my %here;
1532     my $tagpat = debiantag('*',access_basedistro);
1533
1534     git_for_each_ref("refs/tags/".$tagpat, sub {
1535         my ($objid,$objtype,$fullrefname,$reftail) = @_;
1536         printdebug "currently $fullrefname=$objid\n";
1537         $here{$fullrefname} = $objid;
1538     });
1539     git_for_each_ref(lrfetchrefs."/tags/".$tagpat, sub {
1540         my ($objid,$objtype,$fullrefname,$reftail) = @_;
1541         my $lref = "refs".substr($fullrefname, length lrfetchrefs);
1542         printdebug "offered $lref=$objid\n";
1543         if (!defined $here{$lref}) {
1544             my @upd = (@git, qw(update-ref), $lref, $objid, '');
1545             runcmd_ordryrun_local @upd;
1546         } elsif ($here{$lref} eq $objid) {
1547         } else {
1548             print STDERR \
1549                 "Not updateting $lref from $here{$lref} to $objid.\n";
1550         }
1551     });
1552 }
1553
1554 sub fetch_from_archive () {
1555     # ensures that lrref() is what is actually in the archive,
1556     #  one way or another
1557     get_archive_dsc();
1558
1559     if ($dsc) {
1560         foreach my $field (@ourdscfield) {
1561             $dsc_hash = $dsc->{$field};
1562             last if defined $dsc_hash;
1563         }
1564         if (defined $dsc_hash) {
1565             $dsc_hash =~ m/\w+/ or fail "invalid hash in .dsc \`$dsc_hash'";
1566             $dsc_hash = $&;
1567             progress "last upload to archive specified git hash";
1568         } else {
1569             progress "last upload to archive has NO git hash";
1570         }
1571     } else {
1572         progress "no version available from the archive";
1573     }
1574
1575     $lastpush_hash = git_get_ref(lrref());
1576     printdebug "previous reference hash=$lastpush_hash\n";
1577     my $hash;
1578     if (defined $dsc_hash) {
1579         fail "missing remote git history even though dsc has hash -".
1580             " could not find ref ".lrref().
1581             " (should have been fetched from ".access_giturl()."#".rrref().")"
1582             unless $lastpush_hash;
1583         $hash = $dsc_hash;
1584         ensure_we_have_orig();
1585         if ($dsc_hash eq $lastpush_hash) {
1586         } elsif (is_fast_fwd($dsc_hash,$lastpush_hash)) {
1587             print STDERR <<END or die $!;
1588
1589 Git commit in archive is behind the last version allegedly pushed/uploaded.
1590 Commit referred to by archive:  $dsc_hash
1591 Last allegedly pushed/uploaded: $lastpush_hash
1592 $later_warning_msg
1593 END
1594             $hash = $lastpush_hash;
1595         } else {
1596             fail "git head (".lrref()."=$lastpush_hash) is not a ".
1597                 "descendant of archive's .dsc hash ($dsc_hash)";
1598         }
1599     } elsif ($dsc) {
1600         $hash = generate_commit_from_dsc();
1601     } elsif ($lastpush_hash) {
1602         # only in git, not in the archive yet
1603         $hash = $lastpush_hash;
1604         print STDERR <<END or die $!;
1605
1606 Package not found in the archive, but has allegedly been pushed using dgit.
1607 $later_warning_msg
1608 END
1609     } else {
1610         printdebug "nothing found!\n";
1611         if (defined $skew_warning_vsn) {
1612             print STDERR <<END or die $!;
1613
1614 Warning: relevant archive skew detected.
1615 Archive allegedly contains $skew_warning_vsn
1616 But we were not able to obtain any version from the archive or git.
1617
1618 END
1619         }
1620         return 0;
1621     }
1622     printdebug "current hash=$hash\n";
1623     if ($lastpush_hash) {
1624         fail "not fast forward on last upload branch!".
1625             " (archive's version left in DGIT_ARCHIVE)"
1626             unless is_fast_fwd($lastpush_hash, $hash);
1627     }
1628     if (defined $skew_warning_vsn) {
1629         mkpath '.git/dgit';
1630         printdebug "SKEW CHECK WANT $skew_warning_vsn\n";
1631         my $clogf = ".git/dgit/changelog.tmp";
1632         runcmd shell_cmd "exec >$clogf",
1633             @git, qw(cat-file blob), "$hash:debian/changelog";
1634         my $gotclogp = parsechangelog("-l$clogf");
1635         my $got_vsn = getfield $gotclogp, 'Version';
1636         printdebug "SKEW CHECK GOT $got_vsn\n";
1637         if (version_compare($got_vsn, $skew_warning_vsn) < 0) {
1638             print STDERR <<END or die $!;
1639
1640 Warning: archive skew detected.  Using the available version:
1641 Archive allegedly contains    $skew_warning_vsn
1642 We were able to obtain only   $got_vsn
1643
1644 END
1645         }
1646     }
1647     if ($lastpush_hash ne $hash) {
1648         my @upd_cmd = (@git, qw(update-ref -m), 'dgit fetch', lrref(), $hash);
1649         if (act_local()) {
1650             cmdoutput @upd_cmd;
1651         } else {
1652             dryrun_report @upd_cmd;
1653         }
1654     }
1655     return 1;
1656 }
1657
1658 sub set_local_git_config ($$) {
1659     my ($k, $v) = @_;
1660     runcmd @git, qw(config), $k, $v;
1661 }
1662
1663 sub setup_mergechangelogs (;$) {
1664     my ($always) = @_;
1665     return unless $always || access_cfg_bool(1, 'setup-mergechangelogs');
1666
1667     my $driver = 'dpkg-mergechangelogs';
1668     my $cb = "merge.$driver";
1669     my $attrs = '.git/info/attributes';
1670     ensuredir '.git/info';
1671
1672     open NATTRS, ">", "$attrs.new" or die "$attrs.new $!";
1673     if (!open ATTRS, "<", $attrs) {
1674         $!==ENOENT or die "$attrs: $!";
1675     } else {
1676         while (<ATTRS>) {
1677             chomp;
1678             next if m{^debian/changelog\s};
1679             print NATTRS $_, "\n" or die $!;
1680         }
1681         ATTRS->error and die $!;
1682         close ATTRS;
1683     }
1684     print NATTRS "debian/changelog merge=$driver\n" or die $!;
1685     close NATTRS;
1686
1687     set_local_git_config "$cb.name", 'debian/changelog merge driver';
1688     set_local_git_config "$cb.driver", 'dpkg-mergechangelogs -m %O %A %B %A';
1689
1690     rename "$attrs.new", "$attrs" or die "$attrs: $!";
1691 }
1692
1693 sub setup_useremail (;$) {
1694     my ($always) = @_;
1695     return unless $always || access_cfg_bool(1, 'setup-useremail');
1696
1697     my $setup = sub {
1698         my ($k, $envvar) = @_;
1699         my $v = access_cfg("user-$k", 'RETURN-UNDEF') // $ENV{$envvar};
1700         return unless defined $v;
1701         set_local_git_config "user.$k", $v;
1702     };
1703
1704     $setup->('email', 'DEBEMAIL');
1705     $setup->('name', 'DEBFULLNAME');
1706 }
1707
1708 sub setup_new_tree () {
1709     setup_mergechangelogs();
1710     setup_useremail();
1711 }
1712
1713 sub clone ($) {
1714     my ($dstdir) = @_;
1715     canonicalise_suite();
1716     badusage "dry run makes no sense with clone" unless act_local();
1717     my $hasgit = check_for_git();
1718     mkdir $dstdir or fail "create \`$dstdir': $!";
1719     changedir $dstdir;
1720     runcmd @git, qw(init -q);
1721     my $giturl = access_giturl(1);
1722     if (defined $giturl) {
1723         set_local_git_config "remote.$remotename.fetch", fetchspec();
1724         open H, "> .git/HEAD" or die $!;
1725         print H "ref: ".lref()."\n" or die $!;
1726         close H or die $!;
1727         runcmd @git, qw(remote add), 'origin', $giturl;
1728     }
1729     if ($hasgit) {
1730         progress "fetching existing git history";
1731         git_fetch_us();
1732         runcmd_ordryrun_local @git, qw(fetch origin);
1733     } else {
1734         progress "starting new git history";
1735     }
1736     fetch_from_archive() or no_such_package;
1737     my $vcsgiturl = $dsc->{'Vcs-Git'};
1738     if (length $vcsgiturl) {
1739         $vcsgiturl =~ s/\s+-b\s+\S+//g;
1740         runcmd @git, qw(remote add vcs-git), $vcsgiturl;
1741     }
1742     setup_new_tree();
1743     runcmd @git, qw(reset --hard), lrref();
1744     printdone "ready for work in $dstdir";
1745 }
1746
1747 sub fetch () {
1748     if (check_for_git()) {
1749         git_fetch_us();
1750     }
1751     fetch_from_archive() or no_such_package();
1752     printdone "fetched into ".lrref();
1753 }
1754
1755 sub pull () {
1756     fetch();
1757     runcmd_ordryrun_local @git, qw(merge -m),"Merge from $csuite [dgit]",
1758         lrref();
1759     printdone "fetched to ".lrref()." and merged into HEAD";
1760 }
1761
1762 sub check_not_dirty () {
1763     foreach my $f (qw(local-options local-patch-header)) {
1764         if (stat_exists "debian/source/$f") {
1765             fail "git tree contains debian/source/$f";
1766         }
1767     }
1768
1769     return if $ignoredirty;
1770
1771     my @cmd = (@git, qw(diff --quiet HEAD));
1772     debugcmd "+",@cmd;
1773     $!=0; $?=0; system @cmd;
1774     return if !$! && !$?;
1775     if (!$! && $?==256) {
1776         fail "working tree is dirty (does not match HEAD)";
1777     } else {
1778         failedcmd @cmd;
1779     }
1780 }
1781
1782 sub commit_admin ($) {
1783     my ($m) = @_;
1784     progress "$m";
1785     runcmd_ordryrun_local @git, qw(commit -m), $m;
1786 }
1787
1788 sub commit_quilty_patch () {
1789     my $output = cmdoutput @git, qw(status --porcelain);
1790     my %adds;
1791     foreach my $l (split /\n/, $output) {
1792         next unless $l =~ m/\S/;
1793         if ($l =~ m{^(?:\?\?| M) (.pc|debian/patches)}) {
1794             $adds{$1}++;
1795         }
1796     }
1797     delete $adds{'.pc'}; # if there wasn't one before, don't add it
1798     if (!%adds) {
1799         progress "nothing quilty to commit, ok.";
1800         return;
1801     }
1802     my @adds = map { s/[][*?\\]/\\$&/g; $_; } sort keys %adds;
1803     runcmd_ordryrun_local @git, qw(add -f), @adds;
1804     commit_admin "Commit Debian 3.0 (quilt) metadata";
1805 }
1806
1807 sub get_source_format () {
1808     my %options;
1809     if (open F, "debian/source/options") {
1810         while (<F>) {
1811             next if m/^\s*\#/;
1812             next unless m/\S/;
1813             s/\s+$//; # ignore missing final newline
1814             if (m/\s*\#\s*/) {
1815                 my ($k, $v) = ($`, $'); #');
1816                 $v =~ s/^"(.*)"$/$1/;
1817                 $options{$k} = $v;
1818             } else {
1819                 $options{$_} = 1;
1820             }
1821         }
1822         F->error and die $!;
1823         close F;
1824     } else {
1825         die $! unless $!==&ENOENT;
1826     }
1827
1828     if (!open F, "debian/source/format") {
1829         die $! unless $!==&ENOENT;
1830         return '';
1831     }
1832     $_ = <F>;
1833     F->error and die $!;
1834     chomp;
1835     return ($_, \%options);
1836 }
1837
1838 sub madformat ($) {
1839     my ($format) = @_;
1840     return 0 unless $format eq '3.0 (quilt)';
1841     if ($quilt_mode eq 'nocheck') {
1842         progress "Not doing any fixup of \`$format' due to --no-quilt-fixup";
1843         return 0;
1844     }
1845     progress "Format \`$format', checking/updating patch stack";
1846     return 1;
1847 }
1848
1849 sub push_parse_changelog ($) {
1850     my ($clogpfn) = @_;
1851
1852     my $clogp = Dpkg::Control::Hash->new();
1853     $clogp->load($clogpfn) or die;
1854
1855     $package = getfield $clogp, 'Source';
1856     my $cversion = getfield $clogp, 'Version';
1857     my $tag = debiantag($cversion, access_basedistro);
1858     runcmd @git, qw(check-ref-format), $tag;
1859
1860     my $dscfn = dscfn($cversion);
1861
1862     return ($clogp, $cversion, $tag, $dscfn);
1863 }
1864
1865 sub push_parse_dsc ($$$) {
1866     my ($dscfn,$dscfnwhat, $cversion) = @_;
1867     $dsc = parsecontrol($dscfn,$dscfnwhat);
1868     my $dversion = getfield $dsc, 'Version';
1869     my $dscpackage = getfield $dsc, 'Source';
1870     ($dscpackage eq $package && $dversion eq $cversion) or
1871         fail "$dscfn is for $dscpackage $dversion".
1872             " but debian/changelog is for $package $cversion";
1873 }
1874
1875 sub push_mktag ($$$$$$$) {
1876     my ($head,$clogp,$tag,
1877         $dscfn,
1878         $changesfile,$changesfilewhat,
1879         $tfn) = @_;
1880
1881     $dsc->{$ourdscfield[0]} = $head;
1882     $dsc->save("$dscfn.tmp") or die $!;
1883
1884     my $changes = parsecontrol($changesfile,$changesfilewhat);
1885     foreach my $field (qw(Source Distribution Version)) {
1886         $changes->{$field} eq $clogp->{$field} or
1887             fail "changes field $field \`$changes->{$field}'".
1888                 " does not match changelog \`$clogp->{$field}'";
1889     }
1890
1891     my $cversion = getfield $clogp, 'Version';
1892     my $clogsuite = getfield $clogp, 'Distribution';
1893
1894     # We make the git tag by hand because (a) that makes it easier
1895     # to control the "tagger" (b) we can do remote signing
1896     my $authline = clogp_authline $clogp;
1897     my $delibs = join(" ", "",@deliberatelies);
1898     my $declaredistro = access_basedistro();
1899     open TO, '>', $tfn->('.tmp') or die $!;
1900     print TO <<END or die $!;
1901 object $head
1902 type commit
1903 tag $tag
1904 tagger $authline
1905
1906 $package release $cversion for $clogsuite ($csuite) [dgit]
1907 [dgit distro=$declaredistro$delibs]
1908 END
1909     foreach my $ref (sort keys %previously) {
1910                     print TO <<END or die $!;
1911 [dgit previously:$ref=$previously{$ref}]
1912 END
1913     }
1914
1915     close TO or die $!;
1916
1917     my $tagobjfn = $tfn->('.tmp');
1918     if ($sign) {
1919         if (!defined $keyid) {
1920             $keyid = access_cfg('keyid','RETURN-UNDEF');
1921         }
1922         if (!defined $keyid) {
1923             $keyid = getfield $clogp, 'Maintainer';
1924         }
1925         unlink $tfn->('.tmp.asc') or $!==&ENOENT or die $!;
1926         my @sign_cmd = (@gpg, qw(--detach-sign --armor));
1927         push @sign_cmd, qw(-u),$keyid if defined $keyid;
1928         push @sign_cmd, $tfn->('.tmp');
1929         runcmd_ordryrun @sign_cmd;
1930         if (act_scary()) {
1931             $tagobjfn = $tfn->('.signed.tmp');
1932             runcmd shell_cmd "exec >$tagobjfn", qw(cat --),
1933                 $tfn->('.tmp'), $tfn->('.tmp.asc');
1934         }
1935     }
1936
1937     return ($tagobjfn);
1938 }
1939
1940 sub sign_changes ($) {
1941     my ($changesfile) = @_;
1942     if ($sign) {
1943         my @debsign_cmd = @debsign;
1944         push @debsign_cmd, "-k$keyid" if defined $keyid;
1945         push @debsign_cmd, "-p$gpg[0]" if $gpg[0] ne 'gpg';
1946         push @debsign_cmd, $changesfile;
1947         runcmd_ordryrun @debsign_cmd;
1948     }
1949 }
1950
1951 sub dopush ($) {
1952     my ($forceflag) = @_;
1953     printdebug "actually entering push\n";
1954     supplementary_message(<<'END');
1955 Push failed, while preparing your push.
1956 You can retry the push, after fixing the problem, if you like.
1957 END
1958     prep_ud();
1959
1960     access_giturl(); # check that success is vaguely likely
1961
1962     my $clogpfn = ".git/dgit/changelog.822.tmp";
1963     runcmd shell_cmd "exec >$clogpfn", qw(dpkg-parsechangelog);
1964
1965     responder_send_file('parsed-changelog', $clogpfn);
1966
1967     my ($clogp, $cversion, $tag, $dscfn) =
1968         push_parse_changelog("$clogpfn");
1969
1970     my $dscpath = "$buildproductsdir/$dscfn";
1971     stat_exists $dscpath or
1972         fail "looked for .dsc $dscfn, but $!;".
1973             " maybe you forgot to build";
1974
1975     responder_send_file('dsc', $dscpath);
1976
1977     push_parse_dsc($dscpath, $dscfn, $cversion);
1978
1979     my $format = getfield $dsc, 'Format';
1980     printdebug "format $format\n";
1981     if (madformat($format)) {
1982         # user might have not used dgit build, so maybe do this now:
1983         commit_quilty_patch();
1984     }
1985     check_not_dirty();
1986     changedir $ud;
1987     progress "checking that $dscfn corresponds to HEAD";
1988     runcmd qw(dpkg-source -x --),
1989         $dscpath =~ m#^/# ? $dscpath : "../../../$dscpath";
1990     my ($tree,$dir) = mktree_in_ud_from_only_subdir();
1991     check_for_vendor_patches() if madformat($dsc->{format});
1992     changedir '../../../..';
1993     my $diffopt = $debuglevel>0 ? '--exit-code' : '--quiet';
1994     my @diffcmd = (@git, qw(diff), $diffopt, $tree);
1995     debugcmd "+",@diffcmd;
1996     $!=0; $?=0;
1997     my $r = system @diffcmd;
1998     if ($r) {
1999         if ($r==256) {
2000             fail "$dscfn specifies a different tree to your HEAD commit;".
2001                 " perhaps you forgot to build".
2002                 ($diffopt eq '--exit-code' ? "" :
2003                  " (run with -D to see full diff output)");
2004         } else {
2005             failedcmd @diffcmd;
2006         }
2007     }
2008     my $head = git_rev_parse('HEAD');
2009     if (!$changesfile) {
2010         my $pat = changespat $cversion;
2011         my @cs = glob "$buildproductsdir/$pat";
2012         fail "failed to find unique changes file".
2013             " (looked for $pat in $buildproductsdir);".
2014             " perhaps you need to use dgit -C"
2015             unless @cs==1;
2016         ($changesfile) = @cs;
2017     } else {
2018         $changesfile = "$buildproductsdir/$changesfile";
2019     }
2020
2021     responder_send_file('changes',$changesfile);
2022     responder_send_command("param head $head");
2023     responder_send_command("param csuite $csuite");
2024
2025     if (deliberately_not_fast_forward) {
2026         git_for_each_ref(lrfetchrefs, sub {
2027             my ($objid,$objtype,$lrfetchrefname,$reftail) = @_;
2028             my $rrefname= substr($lrfetchrefname, length(lrfetchrefs) + 1);
2029             responder_send_command("previously $rrefname=$objid");
2030             $previously{$rrefname} = $objid;
2031         });
2032     }
2033
2034     my $tfn = sub { ".git/dgit/tag$_[0]"; };
2035     my $tagobjfn;
2036
2037     supplementary_message(<<'END');
2038 Push failed, while signing the tag.
2039 You can retry the push, after fixing the problem, if you like.
2040 END
2041     # If we manage to sign but fail to record it anywhere, it's fine.
2042     if ($we_are_responder) {
2043         $tagobjfn = $tfn->('.signed.tmp');
2044         responder_receive_files('signed-tag', $tagobjfn);
2045     } else {
2046         $tagobjfn =
2047             push_mktag($head,$clogp,$tag,
2048                        $dscpath,
2049                        $changesfile,$changesfile,
2050                        $tfn);
2051     }
2052     supplementary_message(<<'END');
2053 Push failed, *after* signing the tag.
2054 If you want to try again, you should use a new version number.
2055 END
2056
2057     my $tag_obj_hash = cmdoutput @git, qw(hash-object -w -t tag), $tagobjfn;
2058     runcmd_ordryrun @git, qw(verify-tag), $tag_obj_hash;
2059     runcmd_ordryrun_local @git, qw(update-ref), "refs/tags/$tag", $tag_obj_hash;
2060
2061     supplementary_message(<<'END');
2062 Push failed, while updating the remote git repository - see messages above.
2063 If you want to try again, you should use a new version number.
2064 END
2065     if (!check_for_git()) {
2066         create_remote_git_repo();
2067     }
2068     runcmd_ordryrun @git, qw(push),access_giturl(),
2069         $forceflag."HEAD:".rrref(), $forceflag."refs/tags/$tag";
2070     runcmd_ordryrun @git, qw(update-ref -m), 'dgit push', lrref(), 'HEAD';
2071
2072     supplementary_message(<<'END');
2073 Push failed, after updating the remote git repository.
2074 If you want to try again, you must use a new version number.
2075 END
2076     if ($we_are_responder) {
2077         my $dryrunsuffix = act_local() ? "" : ".tmp";
2078         responder_receive_files('signed-dsc-changes',
2079                                 "$dscpath$dryrunsuffix",
2080                                 "$changesfile$dryrunsuffix");
2081     } else {
2082         if (act_local()) {
2083             rename "$dscpath.tmp",$dscpath or die "$dscfn $!";
2084         } else {
2085             progress "[new .dsc left in $dscpath.tmp]";
2086         }
2087         sign_changes $changesfile;
2088     }
2089
2090     supplementary_message(<<END);
2091 Push failed, while uploading package(s) to the archive server.
2092 You can retry the upload of exactly these same files with dput of:
2093   $changesfile
2094 If that .changes file is broken, you will need to use a new version
2095 number for your next attempt at the upload.
2096 END
2097     my $host = access_cfg('upload-host','RETURN-UNDEF');
2098     my @hostarg = defined($host) ? ($host,) : ();
2099     runcmd_ordryrun @dput, @hostarg, $changesfile;
2100     printdone "pushed and uploaded $cversion";
2101
2102     supplementary_message('');
2103     responder_send_command("complete");
2104 }
2105
2106 sub cmd_clone {
2107     parseopts();
2108     notpushing();
2109     my $dstdir;
2110     badusage "-p is not allowed with clone; specify as argument instead"
2111         if defined $package;
2112     if (@ARGV==1) {
2113         ($package) = @ARGV;
2114     } elsif (@ARGV==2 && $ARGV[1] =~ m#^\w#) {
2115         ($package,$isuite) = @ARGV;
2116     } elsif (@ARGV==2 && $ARGV[1] =~ m#^[./]#) {
2117         ($package,$dstdir) = @ARGV;
2118     } elsif (@ARGV==3) {
2119         ($package,$isuite,$dstdir) = @ARGV;
2120     } else {
2121         badusage "incorrect arguments to dgit clone";
2122     }
2123     $dstdir ||= "$package";
2124
2125     if (stat_exists $dstdir) {
2126         fail "$dstdir already exists";
2127     }
2128
2129     my $cwd_remove;
2130     if ($rmonerror && !$dryrun_level) {
2131         $cwd_remove= getcwd();
2132         unshift @end, sub {
2133             return unless defined $cwd_remove;
2134             if (!chdir "$cwd_remove") {
2135                 return if $!==&ENOENT;
2136                 die "chdir $cwd_remove: $!";
2137             }
2138             if (stat $dstdir) {
2139                 rmtree($dstdir) or die "remove $dstdir: $!\n";
2140             } elsif (!grep { $! == $_ }
2141                      (ENOENT, ENOTDIR, EACCES, EPERM, ELOOP)) {
2142             } else {
2143                 print STDERR "check whether to remove $dstdir: $!\n";
2144             }
2145         };
2146     }
2147
2148     clone($dstdir);
2149     $cwd_remove = undef;
2150 }
2151
2152 sub branchsuite () {
2153     my $branch = cmdoutput_errok @git, qw(symbolic-ref HEAD);
2154     if ($branch =~ m#$lbranch_re#o) {
2155         return $1;
2156     } else {
2157         return undef;
2158     }
2159 }
2160
2161 sub fetchpullargs () {
2162     notpushing();
2163     if (!defined $package) {
2164         my $sourcep = parsecontrol('debian/control','debian/control');
2165         $package = getfield $sourcep, 'Source';
2166     }
2167     if (@ARGV==0) {
2168 #       $isuite = branchsuite();  # this doesn't work because dak hates canons
2169         if (!$isuite) {
2170             my $clogp = parsechangelog();
2171             $isuite = getfield $clogp, 'Distribution';
2172         }
2173         canonicalise_suite();
2174         progress "fetching from suite $csuite";
2175     } elsif (@ARGV==1) {
2176         ($isuite) = @ARGV;
2177         canonicalise_suite();
2178     } else {
2179         badusage "incorrect arguments to dgit fetch or dgit pull";
2180     }
2181 }
2182
2183 sub cmd_fetch {
2184     parseopts();
2185     fetchpullargs();
2186     fetch();
2187 }
2188
2189 sub cmd_pull {
2190     parseopts();
2191     fetchpullargs();
2192     pull();
2193 }
2194
2195 sub cmd_push {
2196     parseopts();
2197     pushing();
2198     badusage "-p is not allowed with dgit push" if defined $package;
2199     check_not_dirty();
2200     my $clogp = parsechangelog();
2201     $package = getfield $clogp, 'Source';
2202     my $specsuite;
2203     if (@ARGV==0) {
2204     } elsif (@ARGV==1) {
2205         ($specsuite) = (@ARGV);
2206     } else {
2207         badusage "incorrect arguments to dgit push";
2208     }
2209     $isuite = getfield $clogp, 'Distribution';
2210     if ($new_package) {
2211         local ($package) = $existing_package; # this is a hack
2212         canonicalise_suite();
2213     } else {
2214         canonicalise_suite();
2215     }
2216     if (defined $specsuite &&
2217         $specsuite ne $isuite &&
2218         $specsuite ne $csuite) {
2219             fail "dgit push: changelog specifies $isuite ($csuite)".
2220                 " but command line specifies $specsuite";
2221     }
2222     supplementary_message(<<'END');
2223 Push failed, while checking state of the archive.
2224 You can retry the push, after fixing the problem, if you like.
2225 END
2226     if (check_for_git()) {
2227         git_fetch_us();
2228     }
2229     my $forceflag = '';
2230     if (fetch_from_archive()) {
2231         if (is_fast_fwd(lrref(), 'HEAD')) {
2232             # ok
2233         } elsif (deliberately_not_fast_forward) {
2234             $forceflag = '+';
2235         } else {
2236             fail "dgit push: HEAD is not a descendant".
2237                 " of the archive's version.\n".
2238                 "dgit: To overwrite its contents,".
2239                 " use git merge -s ours ".lrref().".\n".
2240                 "dgit: To rewind history, if permitted by the archive,".
2241                 " use --deliberately-not-fast-forward";
2242         }
2243     } else {
2244         $new_package or
2245             fail "package appears to be new in this suite;".
2246                 " if this is intentional, use --new";
2247     }
2248     dopush($forceflag);
2249 }
2250
2251 #---------- remote commands' implementation ----------
2252
2253 sub cmd_remote_push_build_host {
2254     my ($nrargs) = shift @ARGV;
2255     my (@rargs) = @ARGV[0..$nrargs-1];
2256     @ARGV = @ARGV[$nrargs..$#ARGV];
2257     die unless @rargs;
2258     my ($dir,$vsnwant) = @rargs;
2259     # vsnwant is a comma-separated list; we report which we have
2260     # chosen in our ready response (so other end can tell if they
2261     # offered several)
2262     $debugprefix = ' ';
2263     $we_are_responder = 1;
2264     $us .= " (build host)";
2265
2266     pushing();
2267
2268     open PI, "<&STDIN" or die $!;
2269     open STDIN, "/dev/null" or die $!;
2270     open PO, ">&STDOUT" or die $!;
2271     autoflush PO 1;
2272     open STDOUT, ">&STDERR" or die $!;
2273     autoflush STDOUT 1;
2274
2275     $vsnwant //= 1;
2276     ($protovsn) = grep {
2277         $vsnwant =~ m{^(?:.*,)?$_(?:,.*)?$}
2278     } @rpushprotovsn_support;
2279
2280     fail "build host has dgit rpush protocol versions ".
2281         (join ",", @rpushprotovsn_support).
2282         " but invocation host has $vsnwant"
2283         unless defined $protovsn;
2284
2285     responder_send_command("dgit-remote-push-ready $protovsn");
2286
2287     changedir $dir;
2288     &cmd_push;
2289 }
2290
2291 sub cmd_remote_push_responder { cmd_remote_push_build_host(); }
2292 # ... for compatibility with proto vsn.1 dgit (just so that user gets
2293 #     a good error message)
2294
2295 our $i_tmp;
2296
2297 sub i_cleanup {
2298     local ($@, $?);
2299     my $report = i_child_report();
2300     if (defined $report) {
2301         printdebug "($report)\n";
2302     } elsif ($i_child_pid) {
2303         printdebug "(killing build host child $i_child_pid)\n";
2304         kill 15, $i_child_pid;
2305     }
2306     if (defined $i_tmp && !defined $initiator_tempdir) {
2307         changedir "/";
2308         eval { rmtree $i_tmp; };
2309     }
2310 }
2311
2312 END { i_cleanup(); }
2313
2314 sub i_method {
2315     my ($base,$selector,@args) = @_;
2316     $selector =~ s/\-/_/g;
2317     { no strict qw(refs); &{"${base}_${selector}"}(@args); }
2318 }
2319
2320 sub cmd_rpush {
2321     pushing();
2322     my $host = nextarg;
2323     my $dir;
2324     if ($host =~ m/^((?:[^][]|\[[^][]*\])*)\:/) {
2325         $host = $1;
2326         $dir = $'; #';
2327     } else {
2328         $dir = nextarg;
2329     }
2330     $dir =~ s{^-}{./-};
2331     my @rargs = ($dir);
2332     push @rargs, join ",", @rpushprotovsn_support;
2333     my @rdgit;
2334     push @rdgit, @dgit;
2335     push @rdgit, @ropts;
2336     push @rdgit, qw(remote-push-build-host), (scalar @rargs), @rargs;
2337     push @rdgit, @ARGV;
2338     my @cmd = (@ssh, $host, shellquote @rdgit);
2339     debugcmd "+",@cmd;
2340
2341     if (defined $initiator_tempdir) {
2342         rmtree $initiator_tempdir;
2343         mkdir $initiator_tempdir, 0700 or die "$initiator_tempdir: $!";
2344         $i_tmp = $initiator_tempdir;
2345     } else {
2346         $i_tmp = tempdir();
2347     }
2348     $i_child_pid = open2(\*RO, \*RI, @cmd);
2349     changedir $i_tmp;
2350     ($protovsn) = initiator_expect { m/^dgit-remote-push-ready (\S+)/ };
2351     die "$protovsn ?" unless grep { $_ eq $protovsn } @rpushprotovsn_support;
2352     $supplementary_message = '' unless $protovsn >= 3;
2353     for (;;) {
2354         my ($icmd,$iargs) = initiator_expect {
2355             m/^(\S+)(?: (.*))?$/;
2356             ($1,$2);
2357         };
2358         i_method "i_resp", $icmd, $iargs;
2359     }
2360 }
2361
2362 sub i_resp_progress ($) {
2363     my ($rhs) = @_;
2364     my $msg = protocol_read_bytes \*RO, $rhs;
2365     progress $msg;
2366 }
2367
2368 sub i_resp_supplementary_message ($) {
2369     my ($rhs) = @_;
2370     $supplementary_message = protocol_read_bytes \*RO, $rhs;
2371 }
2372
2373 sub i_resp_complete {
2374     my $pid = $i_child_pid;
2375     $i_child_pid = undef; # prevents killing some other process with same pid
2376     printdebug "waiting for build host child $pid...\n";
2377     my $got = waitpid $pid, 0;
2378     die $! unless $got == $pid;
2379     die "build host child failed $?" if $?;
2380
2381     i_cleanup();
2382     printdebug "all done\n";
2383     exit 0;
2384 }
2385
2386 sub i_resp_file ($) {
2387     my ($keyword) = @_;
2388     my $localname = i_method "i_localname", $keyword;
2389     my $localpath = "$i_tmp/$localname";
2390     stat_exists $localpath and
2391         badproto \*RO, "file $keyword ($localpath) twice";
2392     protocol_receive_file \*RO, $localpath;
2393     i_method "i_file", $keyword;
2394 }
2395
2396 our %i_param;
2397
2398 sub i_resp_param ($) {
2399     $_[0] =~ m/^(\S+) (.*)$/ or badproto \*RO, "bad param spec";
2400     $i_param{$1} = $2;
2401 }
2402
2403 sub i_resp_previously ($) {
2404     $_[0] =~ m#^(refs/tags/\S+)=(\w+)$#
2405         or badproto \*RO, "bad previously spec";
2406     my $r = system qw(git check-ref-format), $1;
2407     die "bad previously ref spec ($r)" if $r;
2408     $previously{$1} = $2;
2409 }
2410
2411 our %i_wanted;
2412
2413 sub i_resp_want ($) {
2414     my ($keyword) = @_;
2415     die "$keyword ?" if $i_wanted{$keyword}++;
2416     my @localpaths = i_method "i_want", $keyword;
2417     printdebug "[[  $keyword @localpaths\n";
2418     foreach my $localpath (@localpaths) {
2419         protocol_send_file \*RI, $localpath;
2420     }
2421     print RI "files-end\n" or die $!;
2422 }
2423
2424 our ($i_clogp, $i_version, $i_tag, $i_dscfn, $i_changesfn);
2425
2426 sub i_localname_parsed_changelog {
2427     return "remote-changelog.822";
2428 }
2429 sub i_file_parsed_changelog {
2430     ($i_clogp, $i_version, $i_tag, $i_dscfn) =
2431         push_parse_changelog "$i_tmp/remote-changelog.822";
2432     die if $i_dscfn =~ m#/|^\W#;
2433 }
2434
2435 sub i_localname_dsc {
2436     defined $i_dscfn or badproto \*RO, "dsc (before parsed-changelog)";
2437     return $i_dscfn;
2438 }
2439 sub i_file_dsc { }
2440
2441 sub i_localname_changes {
2442     defined $i_dscfn or badproto \*RO, "dsc (before parsed-changelog)";
2443     $i_changesfn = $i_dscfn;
2444     $i_changesfn =~ s/\.dsc$/_dgit.changes/ or die;
2445     return $i_changesfn;
2446 }
2447 sub i_file_changes { }
2448
2449 sub i_want_signed_tag {
2450     printdebug Dumper(\%i_param, $i_dscfn);
2451     defined $i_param{'head'} && defined $i_dscfn && defined $i_clogp
2452         && defined $i_param{'csuite'}
2453         or badproto \*RO, "premature desire for signed-tag";
2454     my $head = $i_param{'head'};
2455     die if $head =~ m/[^0-9a-f]/ || $head !~ m/^../;
2456
2457     die unless $i_param{'csuite'} =~ m/^$suite_re$/;
2458     $csuite = $&;
2459     push_parse_dsc $i_dscfn, 'remote dsc', $i_version;
2460
2461     my $tagobjfn =
2462         push_mktag $head, $i_clogp, $i_tag,
2463             $i_dscfn,
2464             $i_changesfn, 'remote changes',
2465             sub { "tag$_[0]"; };
2466
2467     return $tagobjfn;
2468 }
2469
2470 sub i_want_signed_dsc_changes {
2471     rename "$i_dscfn.tmp","$i_dscfn" or die "$i_dscfn $!";
2472     sign_changes $i_changesfn;
2473     return ($i_dscfn, $i_changesfn);
2474 }
2475
2476 #---------- building etc. ----------
2477
2478 our $version;
2479 our $sourcechanges;
2480 our $dscfn;
2481
2482 #----- `3.0 (quilt)' handling -----
2483
2484 our $fakeeditorenv = 'DGIT_FAKE_EDITOR_QUILT';
2485
2486 sub quiltify_dpkg_commit ($$$;$) {
2487     my ($patchname,$author,$msg, $xinfo) = @_;
2488     $xinfo //= '';
2489
2490     mkpath '.git/dgit';
2491     my $descfn = ".git/dgit/quilt-description.tmp";
2492     open O, '>', $descfn or die "$descfn: $!";
2493     $msg =~ s/\s+$//g;
2494     $msg =~ s/\n/\n /g;
2495     $msg =~ s/^\s+$/ ./mg;
2496     print O <<END or die $!;
2497 Description: $msg
2498 Author: $author
2499 $xinfo
2500 ---
2501
2502 END
2503     close O or die $!;
2504
2505     {
2506         local $ENV{'EDITOR'} = cmdoutput qw(realpath --), $0;
2507         local $ENV{'VISUAL'} = $ENV{'EDITOR'};
2508         local $ENV{$fakeeditorenv} = cmdoutput qw(realpath --), $descfn;
2509         runcmd @dpkgsource, qw(--commit .), $patchname;
2510     }
2511 }
2512
2513 sub quiltify_trees_differ ($$;$) {
2514     my ($x,$y,$finegrained) = @_;
2515     # returns true iff the two tree objects differ other than in debian/
2516     # returns bitmas 01 - differ in upstream files except .gitignore
2517     #                02 - differ in .gitignore
2518     local $/=undef;
2519     my @cmd = (@git, qw(diff-tree --name-only -z));
2520     push @cmd, qw(-r) if $finegrained;
2521     push @cmd, $x, $y;
2522     my $diffs= cmdoutput @cmd;
2523     my $r = 0;
2524     foreach my $f (split /\0/, $diffs) {
2525         next if $f =~ m#^debian(?:/.*)?$#s;
2526         $r |= ($f =~ m#^(?:.*/)?.gitignore$#s) ? 02 : 01;
2527     }
2528     printdebug "quiltify_trees_differ $x $y => $r\n";
2529     return $r;
2530 }
2531
2532 sub quiltify_tree_sentinelfiles ($) {
2533     # lists the `sentinel' files present in the tree
2534     my ($x) = @_;
2535     my $r = cmdoutput @git, qw(ls-tree --name-only), $x,
2536         qw(-- debian/rules debian/control);
2537     $r =~ s/\n/,/g;
2538     return $r;
2539 }
2540
2541 sub quiltify_splitbrain () {
2542     # memoisation via git-reflog
2543     my $may_apply = $quilt_mode =~ m/gbp|unapplied/;
2544     die "xxx not yet implemented";
2545 #    if ($may_apply &&
2546 #       quiltify_trees_differ($userhead,)) {}
2547 }
2548
2549 sub quiltify ($$$$) {
2550     my ($clogp,$target,$oldtiptree,$failsuggestion) = @_;
2551
2552     # Quilt patchification algorithm
2553     #
2554     # We search backwards through the history of the main tree's HEAD
2555     # (T) looking for a start commit S whose tree object is identical
2556     # to to the patch tip tree (ie the tree corresponding to the
2557     # current dpkg-committed patch series).  For these purposes
2558     # `identical' disregards anything in debian/ - this wrinkle is
2559     # necessary because dpkg-source treates debian/ specially.
2560     #
2561     # We can only traverse edges where at most one of the ancestors'
2562     # trees differs (in changes outside in debian/).  And we cannot
2563     # handle edges which change .pc/ or debian/patches.  To avoid
2564     # going down a rathole we avoid traversing edges which introduce
2565     # debian/rules or debian/control.  And we set a limit on the
2566     # number of edges we are willing to look at.
2567     #
2568     # If we succeed, we walk forwards again.  For each traversed edge
2569     # PC (with P parent, C child) (starting with P=S and ending with
2570     # C=T) to we do this:
2571     #  - git checkout C
2572     #  - dpkg-source --commit with a patch name and message derived from C
2573     # After traversing PT, we git commit the changes which
2574     # should be contained within debian/patches.
2575
2576     # The search for the path S..T is breadth-first.  We maintain a
2577     # todo list containing search nodes.  A search node identifies a
2578     # commit, and looks something like this:
2579     #  $p = {
2580     #      Commit => $git_commit_id,
2581     #      Child => $c,                          # or undef if P=T
2582     #      Whynot => $reason_edge_PC_unsuitable, # in @nots only
2583     #      Nontrivial => true iff $p..$c has relevant changes
2584     #  };
2585
2586     my @todo;
2587     my @nots;
2588     my $sref_S;
2589     my $max_work=100;
2590     my %considered; # saves being exponential on some weird graphs
2591
2592     my $t_sentinels = quiltify_tree_sentinelfiles $target;
2593
2594     my $not = sub {
2595         my ($search,$whynot) = @_;
2596         printdebug " search NOT $search->{Commit} $whynot\n";
2597         $search->{Whynot} = $whynot;
2598         push @nots, $search;
2599         no warnings qw(exiting);
2600         next;
2601     };
2602
2603     push @todo, {
2604         Commit => $target,
2605     };
2606
2607     while (@todo) {
2608         my $c = shift @todo;
2609         next if $considered{$c->{Commit}}++;
2610
2611         $not->($c, "maximum search space exceeded") if --$max_work <= 0;
2612
2613         printdebug "quiltify investigate $c->{Commit}\n";
2614
2615         # are we done?
2616         if (!quiltify_trees_differ $c->{Commit}, $oldtiptree) {
2617             printdebug " search finished hooray!\n";
2618             $sref_S = $c;
2619             last;
2620         }
2621
2622         if ($quilt_mode eq 'nofix') {
2623             fail "quilt fixup required but quilt mode is \`nofix'\n".
2624                 "HEAD commit $c->{Commit} differs from tree implied by ".
2625                 " debian/patches (tree object $oldtiptree)";
2626         }
2627         if ($quilt_mode eq 'smash') {
2628             printdebug " search quitting smash\n";
2629             last;
2630         }
2631
2632         my $c_sentinels = quiltify_tree_sentinelfiles $c->{Commit};
2633         $not->($c, "has $c_sentinels not $t_sentinels")
2634             if $c_sentinels ne $t_sentinels;
2635
2636         my $commitdata = cmdoutput @git, qw(cat-file commit), $c->{Commit};
2637         $commitdata =~ m/\n\n/;
2638         $commitdata =~ $`;
2639         my @parents = ($commitdata =~ m/^parent (\w+)$/gm);
2640         @parents = map { { Commit => $_, Child => $c } } @parents;
2641
2642         $not->($c, "root commit") if !@parents;
2643
2644         foreach my $p (@parents) {
2645             $p->{Nontrivial}= quiltify_trees_differ $p->{Commit},$c->{Commit};
2646         }
2647         my $ndiffers = grep { $_->{Nontrivial} } @parents;
2648         $not->($c, "merge ($ndiffers nontrivial parents)") if $ndiffers > 1;
2649
2650         foreach my $p (@parents) {
2651             printdebug "considering C=$c->{Commit} P=$p->{Commit}\n";
2652
2653             my @cmd= (@git, qw(diff-tree -r --name-only),
2654                       $p->{Commit},$c->{Commit}, qw(-- debian/patches .pc));
2655             my $patchstackchange = cmdoutput @cmd;
2656             if (length $patchstackchange) {
2657                 $patchstackchange =~ s/\n/,/g;
2658                 $not->($p, "changed $patchstackchange");
2659             }
2660
2661             printdebug " search queue P=$p->{Commit} ",
2662                 ($p->{Nontrivial} ? "NT" : "triv"),"\n";
2663             push @todo, $p;
2664         }
2665     }
2666
2667     if (!$sref_S) {
2668         printdebug "quiltify want to smash\n";
2669
2670         my $abbrev = sub {
2671             my $x = $_[0]{Commit};
2672             $x =~ s/(.*?[0-9a-z]{8})[0-9a-z]*$/$1/;
2673             return $x;
2674         };
2675         my $reportnot = sub {
2676             my ($notp) = @_;
2677             my $s = $abbrev->($notp);
2678             my $c = $notp->{Child};
2679             $s .= "..".$abbrev->($c) if $c;
2680             $s .= ": ".$notp->{Whynot};
2681             return $s;
2682         };
2683         if ($quilt_mode eq 'linear') {
2684             print STDERR "$us: quilt fixup cannot be linear.  Stopped at:\n";
2685             foreach my $notp (@nots) {
2686                 print STDERR "$us:  ", $reportnot->($notp), "\n";
2687             }
2688             print STDERR "$us: $_\n" foreach @$failsuggestion;
2689             fail "quilt fixup naive history linearisation failed.\n".
2690  "Use dpkg-source --commit by hand; or, --quilt=smash for one ugly patch";
2691         } elsif ($quilt_mode eq 'smash') {
2692         } elsif ($quilt_mode eq 'auto') {
2693             progress "quilt fixup cannot be linear, smashing...";
2694         } else {
2695             die "$quilt_mode ?";
2696         }
2697
2698         my $time = time;
2699         my $ncommits = 3;
2700         my $msg = cmdoutput @git, qw(log), "-n$ncommits";
2701
2702         quiltify_dpkg_commit "auto-$version-$target-$time",
2703             (getfield $clogp, 'Maintainer'),
2704             "Automatically generated patch ($clogp->{Version})\n".
2705             "Last (up to) $ncommits git changes, FYI:\n\n". $msg;
2706         return;
2707     }
2708
2709     progress "quiltify linearisation planning successful, executing...";
2710
2711     for (my $p = $sref_S;
2712          my $c = $p->{Child};
2713          $p = $p->{Child}) {
2714         printdebug "quiltify traverse $p->{Commit}..$c->{Commit}\n";
2715         next unless $p->{Nontrivial};
2716
2717         my $cc = $c->{Commit};
2718
2719         my $commitdata = cmdoutput @git, qw(cat-file commit), $cc;
2720         $commitdata =~ m/\n\n/ or die "$c ?";
2721         $commitdata = $`;
2722         my $msg = $'; #';
2723         $commitdata =~ m/^author (.*) \d+ [-+0-9]+$/m or die "$cc ?";
2724         my $author = $1;
2725
2726         $msg =~ s/^(.*)\n*/$1\n/ or die "$cc $msg ?";
2727
2728         my $title = $1;
2729         my $patchname = $title;
2730         $patchname =~ s/[.:]$//;
2731         $patchname =~ y/ A-Z/-a-z/;
2732         $patchname =~ y/-a-z0-9_.+=~//cd;
2733         $patchname =~ s/^\W/x-$&/;
2734         $patchname = substr($patchname,0,40);
2735         my $index;
2736         for ($index='';
2737              stat "debian/patches/$patchname$index";
2738              $index++) { }
2739         $!==ENOENT or die "$patchname$index $!";
2740
2741         runcmd @git, qw(checkout -q), $cc;
2742
2743         # We use the tip's changelog so that dpkg-source doesn't
2744         # produce complaining messages from dpkg-parsechangelog.  None
2745         # of the information dpkg-source gets from the changelog is
2746         # actually relevant - it gets put into the original message
2747         # which dpkg-source provides our stunt editor, and then
2748         # overwritten.
2749         runcmd @git, qw(checkout -q), $target, qw(debian/changelog);
2750
2751         quiltify_dpkg_commit "$patchname$index", $author, $msg,
2752             "X-Dgit-Generated: $clogp->{Version} $cc\n";
2753
2754         runcmd @git, qw(checkout -q), $cc, qw(debian/changelog);
2755     }
2756
2757     runcmd @git, qw(checkout -q master);
2758 }
2759
2760 sub build_maybe_quilt_fixup () {
2761     my ($format,$fopts) = get_source_format;
2762     return unless madformat $format;
2763     # sigh
2764
2765     check_for_vendor_patches();
2766
2767     my $clogp = parsechangelog();
2768     my $headref = git_rev_parse('HEAD');
2769
2770     prep_ud();
2771     changedir $ud;
2772
2773     my $upstreamversion=$version;
2774     $upstreamversion =~ s/-[^-]*$//;
2775
2776     if ($fopts->{'single-debian-patch'}) {
2777         quilt_fixup_singlepatch($clogp, $headref, $upstreamversion);
2778     } else {
2779         quilt_fixup_multipatch($clogp, $headref, $upstreamversion);
2780     }
2781
2782     changedir '../../../..';
2783     runcmd_ordryrun_local
2784         @git, qw(pull --ff-only -q .git/dgit/unpack/work master);
2785 }
2786
2787 sub quilt_fixup_mkwork ($) {
2788     my ($headref) = @_;
2789
2790     mkdir "work" or die $!;
2791     changedir "work";
2792     mktree_in_ud_here();
2793     runcmd @git, qw(reset -q --hard), $headref;
2794 }
2795
2796 sub quilt_fixup_linkorigs ($$) {
2797     my ($upstreamversion, $fn) = @_;
2798     # calls $fn->($leafname);
2799
2800     foreach my $f (<../../../../*>) { #/){
2801         my $b=$f; $b =~ s{.*/}{};
2802         {
2803             local ($debuglevel) = $debuglevel-1;
2804             printdebug "QF linkorigs $b, $f ?\n";
2805         }
2806         next unless is_orig_file $b, srcfn $upstreamversion,'';
2807         printdebug "QF linkorigs $b, $f Y\n";
2808         link_ltarget $f, $b or die "$b $!";
2809         $fn->($b);
2810     }
2811 }
2812
2813 sub quilt_fixup_delete_pc () {
2814     runcmd @git, qw(rm -rqf .pc);
2815     commit_admin "Commit removal of .pc (quilt series tracking data)";
2816 }
2817
2818 sub quilt_fixup_singlepatch ($$$) {
2819     my ($clogp, $headref, $upstreamversion) = @_;
2820
2821     progress "starting quiltify (single-debian-patch)";
2822
2823     # dpkg-source --commit generates new patches even if
2824     # single-debian-patch is in debian/source/options.  In order to
2825     # get it to generate debian/patches/debian-changes, it is
2826     # necessary to build the source package.
2827
2828     quilt_fixup_linkorigs($upstreamversion, sub { });
2829     quilt_fixup_mkwork($headref);
2830
2831     rmtree("debian/patches");
2832
2833     runcmd @dpkgsource, qw(-b .);
2834     chdir "..";
2835     runcmd @dpkgsource, qw(-x), (srcfn $version, ".dsc");
2836     rename srcfn("$upstreamversion", "/debian/patches"),
2837            "work/debian/patches";
2838
2839     chdir "work";
2840     commit_quilty_patch();
2841
2842
2843 }
2844
2845 sub quilt_fixup_multipatch ($$$) {
2846     my ($clogp, $headref, $upstreamversion) = @_;
2847
2848     progress "starting quiltify (multiple patches, $quilt_mode mode)";
2849
2850     # Our objective is:
2851     #  - honour any existing .pc in case it has any strangeness
2852     #  - determine the git commit corresponding to the tip of
2853     #    the patch stack (if there is one)
2854     #  - if there is such a git commit, convert each subsequent
2855     #    git commit into a quilt patch with dpkg-source --commit
2856     #  - otherwise convert all the differences in the tree into
2857     #    a single git commit
2858     #
2859     # To do this we:
2860
2861     # Our git tree doesn't necessarily contain .pc.  (Some versions of
2862     # dgit would include the .pc in the git tree.)  If there isn't
2863     # one, we need to generate one by unpacking the patches that we
2864     # have.
2865     #
2866     # We first look for a .pc in the git tree.  If there is one, we
2867     # will use it.  (This is not the normal case.)
2868     #
2869     # Otherwise need to regenerate .pc so that dpkg-source --commit
2870     # can work.  We do this as follows:
2871     #     1. Collect all relevant .orig from parent directory
2872     #     2. Generate a debian.tar.gz out of
2873     #         debian/{patches,rules,source/format,source/options}
2874     #     3. Generate a fake .dsc containing just these fields:
2875     #          Format Source Version Files
2876     #     4. Extract the fake .dsc
2877     #        Now the fake .dsc has a .pc directory.
2878     # (In fact we do this in every case, because in future we will
2879     # want to search for a good base commit for generating patches.)
2880     #
2881     # Then we can actually do the dpkg-source --commit
2882     #     1. Make a new working tree with the same object
2883     #        store as our main tree and check out the main
2884     #        tree's HEAD.
2885     #     2. Copy .pc from the fake's extraction, if necessary
2886     #     3. Run dpkg-source --commit
2887     #     4. If the result has changes to debian/, then
2888     #          - git-add them them
2889     #          - git-add .pc if we had a .pc in-tree
2890     #          - git-commit
2891     #     5. If we had a .pc in-tree, delete it, and git-commit
2892     #     6. Back in the main tree, fast forward to the new HEAD
2893
2894     # Another situation we may have to cope with is gbp-style
2895     # patches-unapplied trees.
2896     #
2897     # We would want to detect these, so we know to escape into
2898     # quilt_fixup_gbp.  However, this is in general not possible.
2899     # Consider a package with a one patch which the dgit user reverts
2900     # (with git-revert or the moral equivalent).
2901     #
2902     # That is indistinguishable in contents from a patches-unapplied
2903     # tree.  And looking at the history to distinguish them is not
2904     # useful because the user might have made a confusing-looking git
2905     # history structure (which ought to produce an error if dgit can't
2906     # cope, not a silent reintroduction of an unwanted patch).
2907     #
2908     # So gbp users will have to pass an option.  But we can usually
2909     # detect their failure to do so: if the tree is not a clean
2910     # patches-applied tree, quilt linearisation fails, but the tree
2911     # _is_ a clean patches-unapplied tree, we can suggest that maybe
2912     # they want --quilt=unapplied.
2913     #
2914     # To help detect this, when we are extracting the fake dsc, we
2915     # first extract it with --skip-patches, and then apply the patches
2916     # afterwards with dpkg-source --before-build.  That lets us save a
2917     # tree object corresponding to .origs.
2918
2919     my $fakeversion="$upstreamversion-~~DGITFAKE";
2920
2921     my $fakedsc=new IO::File 'fake.dsc', '>' or die $!;
2922     print $fakedsc <<END or die $!;
2923 Format: 3.0 (quilt)
2924 Source: $package
2925 Version: $fakeversion
2926 Files:
2927 END
2928
2929     my $dscaddfile=sub {
2930         my ($b) = @_;
2931
2932         my $md = new Digest::MD5;
2933
2934         my $fh = new IO::File $b, '<' or die "$b $!";
2935         stat $fh or die $!;
2936         my $size = -s _;
2937
2938         $md->addfile($fh);
2939         print $fakedsc " ".$md->hexdigest." $size $b\n" or die $!;
2940     };
2941
2942     quilt_fixup_linkorigs($upstreamversion, $dscaddfile);
2943
2944     my @files=qw(debian/source/format debian/rules
2945                  debian/control debian/changelog);
2946     foreach my $maybe (qw(debian/patches debian/source/options
2947                           debian/tests/control)) {
2948         next unless stat_exists "../../../$maybe";
2949         push @files, $maybe;
2950     }
2951
2952     my $debtar= srcfn $fakeversion,'.debian.tar.gz';
2953     runcmd qw(env GZIP=-1 tar -zcf), "./$debtar", qw(-C ../../..), @files;
2954
2955     $dscaddfile->($debtar);
2956     close $fakedsc or die $!;
2957
2958     runcmd qw(sh -ec),
2959         'exec dpkg-source --no-check --skip-patches -x fake.dsc >/dev/null';
2960
2961     my $fakexdir= $package.'-'.(stripepoch $upstreamversion);
2962     rename $fakexdir, "fake" or die "$fakexdir $!";
2963
2964     changedir 'fake';
2965
2966     remove_stray_gits();
2967     mktree_in_ud_here();
2968
2969     rmtree '.pc';
2970
2971     runcmd @git, qw(add -Af .);
2972     my $unapplied=git_write_tree();
2973     printdebug "fake orig tree object $unapplied\n";
2974
2975     ensuredir '.pc';
2976
2977     runcmd qw(sh -ec),
2978         'exec dpkg-source --before-build . >/dev/null';
2979
2980     changedir '..';
2981
2982     quilt_fixup_mkwork($headref);
2983
2984     my $mustdeletepc=0;
2985     if (stat_exists ".pc") {
2986         -d _ or die;
2987         progress "Tree already contains .pc - will use it then delete it.";
2988         $mustdeletepc=1;
2989     } else {
2990         rename '../fake/.pc','.pc' or die $!;
2991     }
2992
2993     changedir '../fake';
2994     rmtree '.pc';
2995     runcmd @git, qw(add -Af .);
2996     my $oldtiptree=git_write_tree();
2997     changedir '../work';
2998
2999
3000     # We calculate some guesswork now about what kind of tree this might
3001     # be.  This is mostly for error reporting.
3002
3003     my $user2unapplied    = quiltify_trees_differ($headref,   $unapplied, 1);
3004     my $user2applied      = quiltify_trees_differ($headref,   $oldtiptree,1);
3005     my $applied2unapplied = quiltify_trees_differ($oldtiptree,$unapplied, 1);
3006
3007     my @dl;
3008     foreach my $b (qw(01 02)) {
3009         foreach my $v ($user2unapplied, $applied2unapplied, $user2applied) {
3010             push @dl, ($v & $b) ? '##' : '==';
3011         }
3012     }
3013     printdebug "differences \@dl @dl.\n";
3014
3015     progress sprintf
3016 "$us: quilt differences: src:  %s orig %s     gitignores:  %s orig %s\n".
3017 "$us: quilt differences:      HEAD %s o+d/p               HEAD %s o+d/p",
3018                              $dl[0], $dl[1],              $dl[3], $dl[4],
3019                                  $dl[2],                     $dl[5];
3020
3021     my @failsuggestion;
3022     if (!($user2unapplied & $applied2unapplied)) {
3023         push @failsuggestion, "This might be a patches-unapplied branch.";
3024     }  elsif (!($user2applied & $applied2unapplied)) {
3025         push @failsuggestion, "This might be a patches-applied branch.";
3026     }
3027     push @failsuggestion, "Maybe you need to specify one of".
3028         " --quilt=gbp --quilt=dpm --quilt=unapplied ?";
3029
3030     if ($quilt_mode =~ m/gbp|dpm|apply/) {
3031         quiltify_splitbrain();
3032         return;
3033     }
3034
3035     quiltify($clogp,$headref,$oldtiptree,\@failsuggestion);
3036
3037     if (!open P, '>>', ".pc/applied-patches") {
3038         $!==&ENOENT or die $!;
3039     } else {
3040         close P;
3041     }
3042
3043     commit_quilty_patch();
3044
3045     if ($mustdeletepc) {
3046         quilt_fixup_delete_pc();
3047     }
3048 }
3049
3050 sub quilt_fixup_editor () {
3051     my $descfn = $ENV{$fakeeditorenv};
3052     my $editing = $ARGV[$#ARGV];
3053     open I1, '<', $descfn or die "$descfn: $!";
3054     open I2, '<', $editing or die "$editing: $!";
3055     unlink $editing or die "$editing: $!";
3056     open O, '>', $editing or die "$editing: $!";
3057     while (<I1>) { print O or die $!; } I1->error and die $!;
3058     my $copying = 0;
3059     while (<I2>) {
3060         $copying ||= m/^\-\-\- /;
3061         next unless $copying;
3062         print O or die $!;
3063     }
3064     I2->error and die $!;
3065     close O or die $1;
3066     exit 0;
3067 }
3068
3069 #----- other building -----
3070
3071 our $suppress_clean;
3072
3073 sub clean_tree () {
3074     return if $suppress_clean;
3075     if ($cleanmode eq 'dpkg-source') {
3076         runcmd_ordryrun_local @dpkgbuildpackage, qw(-T clean);
3077     } elsif ($cleanmode eq 'dpkg-source-d') {
3078         runcmd_ordryrun_local @dpkgbuildpackage, qw(-d -T clean);
3079     } elsif ($cleanmode eq 'git') {
3080         runcmd_ordryrun_local @git, qw(clean -xdf);
3081     } elsif ($cleanmode eq 'git-ff') {
3082         runcmd_ordryrun_local @git, qw(clean -xdff);
3083     } elsif ($cleanmode eq 'check') {
3084         my $leftovers = cmdoutput @git, qw(clean -xdn);
3085         if (length $leftovers) {
3086             print STDERR $leftovers, "\n" or die $!;
3087             fail "tree contains uncommitted files and --clean=check specified";
3088         }
3089     } elsif ($cleanmode eq 'none') {
3090     } else {
3091         die "$cleanmode ?";
3092     }
3093 }
3094
3095 sub cmd_clean () {
3096     badusage "clean takes no additional arguments" if @ARGV;
3097     notpushing();
3098     clean_tree();
3099 }
3100
3101 sub build_prep () {
3102     notpushing();
3103     badusage "-p is not allowed when building" if defined $package;
3104     check_not_dirty();
3105     clean_tree();
3106     my $clogp = parsechangelog();
3107     $isuite = getfield $clogp, 'Distribution';
3108     $package = getfield $clogp, 'Source';
3109     $version = getfield $clogp, 'Version';
3110     build_maybe_quilt_fixup();
3111     if ($rmchanges) {
3112         my $pat = changespat $version;
3113         foreach my $f (glob "$buildproductsdir/$pat") {
3114             if (act_local()) {
3115                 unlink $f or fail "remove old changes file $f: $!";
3116             } else {
3117                 progress "would remove $f";
3118             }
3119         }
3120     }
3121 }
3122
3123 sub changesopts_initial () {
3124     my @opts =@changesopts[1..$#changesopts];
3125 }
3126
3127 sub changesopts_version () {
3128     if (!defined $changes_since_version) {
3129         my @vsns = archive_query('archive_query');
3130         my @quirk = access_quirk();
3131         if ($quirk[0] eq 'backports') {
3132             local $isuite = $quirk[2];
3133             local $csuite;
3134             canonicalise_suite();
3135             push @vsns, archive_query('archive_query');
3136         }
3137         if (@vsns) {
3138             @vsns = map { $_->[0] } @vsns;
3139             @vsns = sort { -version_compare($a, $b) } @vsns;
3140             $changes_since_version = $vsns[0];
3141             progress "changelog will contain changes since $vsns[0]";
3142         } else {
3143             $changes_since_version = '_';
3144             progress "package seems new, not specifying -v<version>";
3145         }
3146     }
3147     if ($changes_since_version ne '_') {
3148         return ("-v$changes_since_version");
3149     } else {
3150         return ();
3151     }
3152 }
3153
3154 sub changesopts () {
3155     return (changesopts_initial(), changesopts_version());
3156 }
3157
3158 sub massage_dbp_args ($;$) {
3159     my ($cmd,$xargs) = @_;
3160     # We need to:
3161     #
3162     #  - if we're going to split the source build out so we can
3163     #    do strange things to it, massage the arguments to dpkg-buildpackage
3164     #    so that the main build doessn't build source (or add an argument
3165     #    to stop it building source by default).
3166     #
3167     #  - add -nc to stop dpkg-source cleaning the source tree,
3168     #    unless we're not doing a split build and want dpkg-source
3169     #    as cleanmode, in which case we can do nothing
3170     #
3171     # return values:
3172     #    0 - source will NOT need to be built separately by caller
3173     #   +1 - source will need to be built separately by caller
3174     #   +2 - source will need to be built separately by caller AND
3175     #        dpkg-buildpackage should not in fact be run at all!
3176     debugcmd '#massaging#', @$cmd if $debuglevel>1;
3177 #print STDERR "MASS0 ",Dumper($cmd, $xargs, $need_split_build_invocation);
3178     if ($cleanmode eq 'dpkg-source' && !$need_split_build_invocation) {
3179         $suppress_clean = 1;
3180         return 0;
3181     }
3182     # -nc has the side effect of specifying -b if nothing else specified
3183     # and some combinations of -S, -b, et al, are errors, rather than
3184     # later simply overriding earlie.  So we need to:
3185     #  - search the command line for these options
3186     #  - pick the last one
3187     #  - perhaps add our own as a default
3188     #  - perhaps adjust it to the corresponding non-source-building version
3189     my $dmode = '-F';
3190     foreach my $l ($cmd, $xargs) {
3191         next unless $l;
3192         @$l = grep { !(m/^-[SgGFABb]$/s and $dmode=$_) } @$l;
3193     }
3194     push @$cmd, '-nc';
3195 #print STDERR "MASS1 ",Dumper($cmd, $xargs, $dmode);
3196     my $r = 0;
3197     if ($need_split_build_invocation) {
3198         $r = $dmode =~ m/[S]/     ? +2 :
3199              $dmode =~ y/gGF/ABb/ ? +1 :
3200              $dmode =~ m/[ABb]/   ?  0 :
3201              die "$dmode ?";
3202     }
3203     push @$cmd, $dmode;
3204 #print STDERR "MASS2 ",Dumper($cmd, $xargs, $r);
3205     return $r;
3206 }
3207
3208 sub cmd_build {
3209     my @dbp = (@dpkgbuildpackage, qw(-us -uc), changesopts_initial(), @ARGV);
3210     my $wantsrc = massage_dbp_args \@dbp;
3211     if ($wantsrc > 0) {
3212         build_source();
3213     } else {
3214         build_prep();
3215     }
3216     if ($wantsrc < 2) {
3217         push @dbp, changesopts_version();
3218         runcmd_ordryrun_local @dbp;
3219     }
3220     printdone "build successful\n";
3221 }
3222
3223 sub cmd_gbp_build {
3224     my @dbp = @dpkgbuildpackage;
3225
3226     my $wantsrc = massage_dbp_args \@dbp, \@ARGV;
3227
3228     my @cmd;
3229     if (length executable_on_path('git-buildpackage')) {
3230         @cmd = qw(git-buildpackage);
3231     } else {
3232         @cmd = qw(gbp buildpackage);
3233     }
3234     push @cmd, (qw(-us -uc --git-no-sign-tags), "--git-builder=@dbp");
3235
3236     if ($wantsrc > 0) {
3237         build_source();
3238     } else {
3239         if (!$suppress_clean) {
3240             push @cmd, '--git-cleaner=true';
3241         }
3242         build_prep();
3243     }
3244     if ($wantsrc < 2) {
3245         unless (grep { m/^--git-debian-branch|^--git-ignore-branch/ } @ARGV) {
3246             canonicalise_suite();
3247             push @cmd, "--git-debian-branch=".lbranch();
3248         }
3249         push @cmd, changesopts();
3250         runcmd_ordryrun_local @cmd, @ARGV;
3251     }
3252     printdone "build successful\n";
3253 }
3254 sub cmd_git_build { cmd_gbp_build(); } # compatibility with <= 1.0
3255
3256 sub build_source {
3257     if ($cleanmode =~ m/^dpkg-source/) {
3258         # dpkg-source will clean, so we shouldn't
3259         $suppress_clean = 1;
3260     }
3261     build_prep();
3262     $sourcechanges = changespat $version,'source';
3263     if (act_local()) {
3264         unlink "../$sourcechanges" or $!==ENOENT
3265             or fail "remove $sourcechanges: $!";
3266     }
3267     $dscfn = dscfn($version);
3268     if ($cleanmode eq 'dpkg-source') {
3269         runcmd_ordryrun_local @dpkgbuildpackage, qw(-us -uc -S),
3270                                changesopts();
3271     } elsif ($cleanmode eq 'dpkg-source-d') {
3272         runcmd_ordryrun_local @dpkgbuildpackage, qw(-us -uc -S -d),
3273                                changesopts();
3274     } else {
3275         my $pwd = must_getcwd();
3276         my $leafdir = basename $pwd;
3277         changedir "..";
3278         runcmd_ordryrun_local @dpkgsource, qw(-b --), $leafdir;
3279         changedir $pwd;
3280         runcmd_ordryrun_local qw(sh -ec),
3281             'exec >$1; shift; exec "$@"','x',
3282             "../$sourcechanges",
3283             @dpkggenchanges, qw(-S), changesopts();
3284     }
3285 }
3286
3287 sub cmd_build_source {
3288     badusage "build-source takes no additional arguments" if @ARGV;
3289     build_source();
3290     printdone "source built, results in $dscfn and $sourcechanges";
3291 }
3292
3293 sub cmd_sbuild {
3294     build_source();
3295     my $pat = changespat $version;
3296     if (!$rmchanges) {
3297         my @unwanted = map { s#^\.\./##; $_; } glob "../$pat";
3298         @unwanted = grep { $_ ne changespat $version,'source' } @unwanted;
3299         fail "changes files other than source matching $pat".
3300             " already present (@unwanted);".
3301             " building would result in ambiguity about the intended results"
3302             if @unwanted;
3303     }
3304     changedir "..";
3305     if (act_local()) {
3306         stat_exists $dscfn or fail "$dscfn (in parent directory): $!";
3307         stat_exists $sourcechanges
3308             or fail "$sourcechanges (in parent directory): $!";
3309     }
3310     runcmd_ordryrun_local @sbuild, qw(-d), $isuite, @ARGV, $dscfn;
3311     my @changesfiles = glob $pat;
3312     @changesfiles = sort {
3313         ($b =~ m/_source\.changes$/ <=> $a =~ m/_source\.changes$/)
3314             or $a cmp $b
3315     } @changesfiles;
3316     fail "wrong number of different changes files (@changesfiles)"
3317         unless @changesfiles==2;
3318     my $binchanges = parsecontrol($changesfiles[1], "binary changes file");
3319     foreach my $l (split /\n/, getfield $binchanges, 'Files') {
3320         fail "$l found in binaries changes file $binchanges"
3321             if $l =~ m/\.dsc$/;
3322     }
3323     runcmd_ordryrun_local @mergechanges, @changesfiles;
3324     my $multichanges = changespat $version,'multi';
3325     if (act_local()) {
3326         stat_exists $multichanges or fail "$multichanges: $!";
3327         foreach my $cf (glob $pat) {
3328             next if $cf eq $multichanges;
3329             rename "$cf", "$cf.inmulti" or fail "$cf\{,.inmulti}: $!";
3330         }
3331     }
3332     printdone "build successful, results in $multichanges\n" or die $!;
3333 }
3334
3335 sub cmd_quilt_fixup {
3336     badusage "incorrect arguments to dgit quilt-fixup" if @ARGV;
3337     my $clogp = parsechangelog();
3338     $version = getfield $clogp, 'Version';
3339     $package = getfield $clogp, 'Source';
3340     check_not_dirty();
3341     clean_tree();
3342     build_maybe_quilt_fixup();
3343 }
3344
3345 sub cmd_archive_api_query {
3346     badusage "need only 1 subpath argument" unless @ARGV==1;
3347     my ($subpath) = @ARGV;
3348     my @cmd = archive_api_query_cmd($subpath);
3349     debugcmd ">",@cmd;
3350     exec @cmd or fail "exec curl: $!\n";
3351 }
3352
3353 sub cmd_clone_dgit_repos_server {
3354     badusage "need destination argument" unless @ARGV==1;
3355     my ($destdir) = @ARGV;
3356     $package = '_dgit-repos-server';
3357     my @cmd = (@git, qw(clone), access_giturl(), $destdir);
3358     debugcmd ">",@cmd;
3359     exec @cmd or fail "exec git clone: $!\n";
3360 }
3361
3362 sub cmd_setup_mergechangelogs {
3363     badusage "no arguments allowed to dgit setup-mergechangelogs" if @ARGV;
3364     setup_mergechangelogs(1);
3365 }
3366
3367 sub cmd_setup_useremail {
3368     badusage "no arguments allowed to dgit setup-mergechangelogs" if @ARGV;
3369     setup_useremail(1);
3370 }
3371
3372 sub cmd_setup_new_tree {
3373     badusage "no arguments allowed to dgit setup-tree" if @ARGV;
3374     setup_new_tree();
3375 }
3376
3377 #---------- argument parsing and main program ----------
3378
3379 sub cmd_version {
3380     print "dgit version $our_version\n" or die $!;
3381     exit 0;
3382 }
3383
3384 our (%valopts_long, %valopts_short);
3385 our @rvalopts;
3386
3387 sub defvalopt ($$$$) {
3388     my ($long,$short,$val_re,$how) = @_;
3389     my $oi = { Long => $long, Short => $short, Re => $val_re, How => $how };
3390     $valopts_long{$long} = $oi;
3391     $valopts_short{$short} = $oi;
3392     # $how subref should:
3393     #   do whatever assignemnt or thing it likes with $_[0]
3394     #   if the option should not be passed on to remote, @rvalopts=()
3395     # or $how can be a scalar ref, meaning simply assign the value
3396 }
3397
3398 defvalopt '--since-version', '-v', '[^_]+|_', \$changes_since_version;
3399 defvalopt '--distro',        '-d', '.+',      \$idistro;
3400 defvalopt '',                '-k', '.+',      \$keyid;
3401 defvalopt '--existing-package','', '.*',      \$existing_package;
3402 defvalopt '--build-products-dir','','.*',     \$buildproductsdir;
3403 defvalopt '--clean',       '', $cleanmode_re, \$cleanmode;
3404 defvalopt '--quilt',     '', $quilt_modes_re, \$quilt_mode;
3405
3406 defvalopt '', '-c', '.*=.*', sub { push @git, '-c', @_; };
3407
3408 defvalopt '', '-C', '.+', sub {
3409     ($changesfile) = (@_);
3410     if ($changesfile =~ s#^(.*)/##) {
3411         $buildproductsdir = $1;
3412     }
3413 };
3414
3415 defvalopt '--initiator-tempdir','','.*', sub {
3416     ($initiator_tempdir) = (@_);
3417     $initiator_tempdir =~ m#^/# or
3418         badusage "--initiator-tempdir must be used specify an".
3419         " absolute, not relative, directory."
3420 };
3421
3422 sub parseopts () {
3423     my $om;
3424
3425     if (defined $ENV{'DGIT_SSH'}) {
3426         @ssh = string_to_ssh $ENV{'DGIT_SSH'};
3427     } elsif (defined $ENV{'GIT_SSH'}) {
3428         @ssh = ($ENV{'GIT_SSH'});
3429     }
3430
3431     my $oi;
3432     my $val;
3433     my $valopt = sub {
3434         my ($what) = @_;
3435         @rvalopts = ($_);
3436         if (!defined $val) {
3437             badusage "$what needs a value" unless @ARGV;
3438             $val = shift @ARGV;
3439             push @rvalopts, $val;
3440         }
3441         badusage "bad value \`$val' for $what" unless
3442             $val =~ m/^$oi->{Re}$(?!\n)/s;
3443         my $how = $oi->{How};
3444         if (ref($how) eq 'SCALAR') {
3445             $$how = $val;
3446         } else {
3447             $how->($val);
3448         }
3449         push @ropts, @rvalopts;
3450     };
3451
3452     while (@ARGV) {
3453         last unless $ARGV[0] =~ m/^-/;
3454         $_ = shift @ARGV;
3455         last if m/^--?$/;
3456         if (m/^--/) {
3457             if (m/^--dry-run$/) {
3458                 push @ropts, $_;
3459                 $dryrun_level=2;
3460             } elsif (m/^--damp-run$/) {
3461                 push @ropts, $_;
3462                 $dryrun_level=1;
3463             } elsif (m/^--no-sign$/) {
3464                 push @ropts, $_;
3465                 $sign=0;
3466             } elsif (m/^--help$/) {
3467                 cmd_help();
3468             } elsif (m/^--version$/) {
3469                 cmd_version();
3470             } elsif (m/^--new$/) {
3471                 push @ropts, $_;
3472                 $new_package=1;
3473             } elsif (m/^--([-0-9a-z]+)=(.+)/s &&
3474                      ($om = $opts_opt_map{$1}) &&
3475                      length $om->[0]) {
3476                 push @ropts, $_;
3477                 $om->[0] = $2;
3478             } elsif (m/^--([-0-9a-z]+):(.*)/s &&
3479                      !$opts_opt_cmdonly{$1} &&
3480                      ($om = $opts_opt_map{$1})) {
3481                 push @ropts, $_;
3482                 push @$om, $2;
3483             } elsif (m/^--ignore-dirty$/s) {
3484                 push @ropts, $_;
3485                 $ignoredirty = 1;
3486             } elsif (m/^--no-quilt-fixup$/s) {
3487                 push @ropts, $_;
3488                 $quilt_mode = 'nocheck';
3489             } elsif (m/^--no-rm-on-error$/s) {
3490                 push @ropts, $_;
3491                 $rmonerror = 0;
3492             } elsif (m/^--(no-)?rm-old-changes$/s) {
3493                 push @ropts, $_;
3494                 $rmchanges = !$1;
3495             } elsif (m/^--deliberately-($deliberately_re)$/s) {
3496                 push @ropts, $_;
3497                 push @deliberatelies, $&;
3498             } elsif (m/^--always-split-source-build$/s) {
3499                 # undocumented, for testing
3500                 push @ropts, $_;
3501                 $need_split_build_invocation = 1;
3502             } elsif (m/^(--[-0-9a-z]+)(=|$)/ && ($oi = $valopts_long{$1})) {
3503                 $val = $2 ? $' : undef; #';
3504                 $valopt->($oi->{Long});
3505             } else {
3506                 badusage "unknown long option \`$_'";
3507             }
3508         } else {
3509             while (m/^-./s) {
3510                 if (s/^-n/-/) {
3511                     push @ropts, $&;
3512                     $dryrun_level=2;
3513                 } elsif (s/^-L/-/) {
3514                     push @ropts, $&;
3515                     $dryrun_level=1;
3516                 } elsif (s/^-h/-/) {
3517                     cmd_help();
3518                 } elsif (s/^-D/-/) {
3519                     push @ropts, $&;
3520                     $debuglevel++;
3521                     enabledebug();
3522                 } elsif (s/^-N/-/) {
3523                     push @ropts, $&;
3524                     $new_package=1;
3525                 } elsif (m/^-m/) {
3526                     push @ropts, $&;
3527                     push @changesopts, $_;
3528                     $_ = '';
3529                 } elsif (s/^-wn$//s) {
3530                     push @ropts, $&;
3531                     $cleanmode = 'none';
3532                 } elsif (s/^-wg$//s) {
3533                     push @ropts, $&;
3534                     $cleanmode = 'git';
3535                 } elsif (s/^-wgf$//s) {
3536                     push @ropts, $&;
3537                     $cleanmode = 'git-ff';
3538                 } elsif (s/^-wd$//s) {
3539                     push @ropts, $&;
3540                     $cleanmode = 'dpkg-source';
3541                 } elsif (s/^-wdd$//s) {
3542                     push @ropts, $&;
3543                     $cleanmode = 'dpkg-source-d';
3544                 } elsif (s/^-wc$//s) {
3545                     push @ropts, $&;
3546                     $cleanmode = 'check';
3547                 } elsif (m/^-[a-zA-Z]/ && ($oi = $valopts_short{$&})) {
3548                     $val = $'; #';
3549                     $val = undef unless length $val;
3550                     $valopt->($oi->{Short});
3551                     $_ = '';
3552                 } else {
3553                     badusage "unknown short option \`$_'";
3554                 }
3555             }
3556         }
3557     }
3558 }
3559
3560 sub finalise_opts_opts () {
3561     foreach my $k (keys %opts_opt_map) {
3562         my $om = $opts_opt_map{$k};
3563
3564         my $v = access_cfg("cmd-$k", 'RETURN-UNDEF');
3565         if (defined $v) {
3566             badcfg "cannot set command for $k"
3567                 unless length $om->[0];
3568             $om->[0] = $v;
3569         }
3570
3571         foreach my $c (access_cfg_cfgs("opts-$k")) {
3572             my $vl = $gitcfg{$c};
3573             printdebug "CL $c ",
3574                 ($vl ? join " ", map { shellquote } @$vl : ""),
3575                 "\n" if $debuglevel >= 4;
3576             next unless $vl;
3577             badcfg "cannot configure options for $k"
3578                 if $opts_opt_cmdonly{$k};
3579             my $insertpos = $opts_cfg_insertpos{$k};
3580             @$om = ( @$om[0..$insertpos-1],
3581                      @$vl,
3582                      @$om[$insertpos..$#$om] );
3583         }
3584     }
3585 }
3586
3587 if ($ENV{$fakeeditorenv}) {
3588     git_slurp_config();
3589     quilt_fixup_editor();
3590 }
3591
3592 parseopts();
3593 git_slurp_config();
3594
3595 print STDERR "DRY RUN ONLY\n" if $dryrun_level > 1;
3596 print STDERR "DAMP RUN - WILL MAKE LOCAL (UNSIGNED) CHANGES\n"
3597     if $dryrun_level == 1;
3598 if (!@ARGV) {
3599     print STDERR $helpmsg or die $!;
3600     exit 8;
3601 }
3602 my $cmd = shift @ARGV;
3603 $cmd =~ y/-/_/;
3604
3605 if (!defined $rmchanges) {
3606     local $access_forpush;
3607     $rmchanges = access_cfg_bool(0, 'rm-old-changes');
3608 }
3609
3610 if (!defined $quilt_mode) {
3611     local $access_forpush;
3612     $quilt_mode = cfg('dgit.force.quilt-mode', 'RETURN-UNDEF')
3613         // access_cfg('quilt-mode', 'RETURN-UNDEF')
3614         // 'linear';
3615     $quilt_mode =~ m/^($quilt_modes_re)$/
3616         or badcfg "unknown quilt-mode \`$quilt_mode'";
3617     $quilt_mode = $1;
3618 }
3619
3620 if (!defined $cleanmode) {
3621     local $access_forpush;
3622     $cleanmode = access_cfg('clean-mode', 'RETURN-UNDEF');
3623     $cleanmode //= 'dpkg-source';
3624
3625     badcfg "unknown clean-mode \`$cleanmode'" unless
3626         $cleanmode =~ m/^($cleanmode_re)$(?!\n)/s;
3627 }
3628
3629 my $fn = ${*::}{"cmd_$cmd"};
3630 $fn or badusage "unknown operation $cmd";
3631 $fn->();