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