]> git.madduck.net Git - code/myrepos.git/blob - mr

madduck's git repository

Every one of the projects in this repository is available at the canonical URL git://git.madduck.net/madduck/pub/<projectpath> — see each project's metadata for the exact URL.

All patches and comments are welcome. Please squash your changes to logical commits before using git-format-patch and git-send-email to patches@git.madduck.net. If you'd read over the Git project's submission guidelines and adhered to them, I'd be especially grateful.

SSH access, as well as push access can be individually arranged.

If you use my repositories frequently, consider adding the following snippet to ~/.gitconfig and using the third clone URL listed for each project:

[url "git://git.madduck.net/madduck/"]
  insteadOf = madduck:

The previous fix for chaining to absolute paths broke chaining to relative paths...
[code/myrepos.git] / mr
1 #!/usr/bin/perl
2
3 =head1 NAME
4
5 mr - a Multiple Repository management tool
6
7 =head1 SYNOPSIS
8
9 B<mr> [options] checkout
10
11 B<mr> [options] update
12
13 B<mr> [options] status
14
15 B<mr> [options] commit [-m "message"]
16
17 B<mr> [options] record [-m "message"]
18
19 B<mr> [options] push
20
21 B<mr> [options] diff
22
23 B<mr> [options] log
24
25 B<mr> [options] run command [param ...]
26
27 B<mr> [options] bootstrap url [directory]
28
29 B<mr> [options] register [repository]
30
31 B<mr> [options] config section ["parameter=[value]" ...]
32
33 B<mr> [options] action [params ...]
34
35 B<mr> [options] [online|offline]
36
37 B<mr> [options] remember action [params ...]
38
39 =head1 DESCRIPTION
40
41 B<mr> is a Multiple Repository management tool. It can checkout, update, or
42 perform other actions on a set of repositories as if they were one combined
43 repository. It supports any combination of subversion, git, cvs, mercurial,
44 bzr, darcs and fossil repositories, and support for other version
45 control systems can easily be added.
46
47 B<mr> cds into and operates on all registered repositories at or below your
48 working directory. Or, if you are in a subdirectory of a repository that
49 contains no other registered repositories, it will stay in that directory,
50 and work on only that repository,
51
52 B<mr> is configured by .mrconfig files, which list the repositories. It
53 starts by reading the .mrconfig file in your home directory, and this can
54 in turn chain load .mrconfig files from repositories. It also automatically
55 looks for a .mrconfig file in the current directory, or in one of its
56 parent directories.
57
58 These predefined commands should be fairly familiar to users of any version
59 control system:
60
61 =over 4
62
63 =item checkout (or co)
64
65 Checks out any repositories that are not already checked out.
66
67 =item update
68
69 Updates each repository from its configured remote repository.
70
71 If a repository isn't checked out yet, it will first check it out.
72
73 =item status
74
75 Displays a status report for each repository, showing what
76 uncommitted changes are present in the repository.
77
78 =item commit (or ci)
79
80 Commits changes to each repository. (By default, changes are pushed to the
81 remote repository too, when using distributed systems like git. If you
82 don't like this default, you can change it in your .mrconfig, or use record
83 instead.)
84
85 The optional -m parameter allows specifying a commit message.
86
87 =item record
88
89 Records changes to the local repository, but does not push them to the
90 remote repository. Only supported for distributed version control systems.
91
92 The optional -m parameter allows specifying a commit message.
93
94 =item push
95
96 Pushes committed local changes to the remote repository. A no-op for
97 centralized version control systems.
98
99 =item diff
100
101 Show a diff of uncommitted changes.
102
103 =item log
104
105 Show the commit log.
106
107 =item run command [param ...]
108
109 Runs the specified command in each repository.
110
111 =back
112
113 These commands are also available:
114
115 =over 4
116
117 =item bootstrap url [directory]
118
119 Causes mr to download the url, and use it as a .mrconfig file
120 to checkout the repositories listed in it, into the specified directory.
121
122 The directory will be created if it does not exist. If no directory is
123 specified, the current directory will be used.
124
125 If the .mrconfig file includes a repository named ".", that
126 is checked out into the top of the specified directory.
127
128 =item list (or ls)
129
130 List the repositories that mr will act on.
131
132 =item register
133
134 Register an existing repository in a mrconfig file. By default, the
135 repository in the current directory is registered, or you can specify a
136 directory to register.
137
138 The mrconfig file that is modified is chosen by either the -c option, or by
139 looking for the closest known one at or in a parent of the current directory.
140
141 =item config
142
143 Adds, modifies, removes, or prints a value from a mrconfig file. The next
144 parameter is the name of the section the value is in. To add or modify
145 values, use one or more instances of "parameter=value". Use "parameter=" to
146 remove a parameter. Use just "parameter" to get the value of a parameter.
147
148 For example, to add (or edit) a repository in src/foo:
149
150   mr config src/foo checkout="svn co svn://example.com/foo/trunk foo"
151
152 To show the command that mr uses to update the repository in src/foo:
153
154   mr config src/foo update
155
156 To see the built-in library of shell functions contained in mr:
157
158   mr config DEFAULT lib
159
160 The mrconfig file that is used is chosen by either the -c option, or by
161 looking for the closest known one at or in a parent of the current directory.
162
163 =item offline
164
165 Advises mr that it is in offline mode. Any commands that fail in
166 offline mode will be remembered, and retried when mr is told it's online.
167
168 =item online
169
170 Advices mr that it is in online mode again. Commands that failed while in
171 offline mode will be re-run.
172
173 =item remember
174
175 Remember a command, to be run later when mr re-enters online mode. This
176 implicitly puts mr into offline mode. The command can be any regular mr
177 command. This is useful when you know that a command will fail due to being
178 offline, and so don't want to run it right now at all, but just remember
179 to run it when you go back online.
180
181 =item help
182
183 Displays this help.
184
185 =back
186
187 Actions can be abbreviated to any unambiguous substring, so
188 "mr st" is equivalent to "mr status", and "mr up" is equivalent to "mr
189 update"
190
191 Additional parameters can be passed to most commands, and are passed on
192 unchanged to the underlying version control system. This is mostly useful
193 if the repositories mr will act on all use the same version control
194 system.
195
196 =head1 OPTIONS
197
198 =over 4
199
200 =item -d directory
201
202 =item --directory directory
203
204 Specifies the topmost directory that B<mr> should work in. The default is
205 the current working directory.
206
207 =item -c mrconfig
208
209 =item --config mrconfig
210
211 Use the specified mrconfig file. The default is to use both B<~/.mrconfig>
212 as well as look for a .mrconfig file in the current directory, or in one
213 of its parent directories.
214
215 =item -v
216
217 =item --verbose
218
219 Be verbose.
220
221 =item -q
222
223 =item --quiet
224
225 Be quiet. This supresses mr's usual output, as well as any output from
226 commands that are run (including stderr output). If a command fails,
227 the output will be shown.
228
229 =item -k
230
231 =item --insecure
232
233 Accept untrusted SSL certificates when bootstrapping.
234
235 =item -s
236
237 =item --stats
238
239 Expand the statistics line displayed at the end to include information
240 about exactly which repositories failed and were skipped, if any.
241
242 =item -i
243
244 =item --interactive
245
246 Interactive mode. If a repository fails to be processed, a subshell will be
247 started which you can use to resolve or investigate the problem. Exit the
248 subshell to continue the mr run.
249
250 =item -n [number]
251
252 =item --no-recurse [number]
253
254 If no number if specified, just operate on the repository for the current
255 directory, do not recurse into deeper repositories.
256
257 If a number is specified, will recurse into repositories at most that many
258 subdirectories deep. For example, with -n 2 it would recurse into ./src/foo,
259 but not ./src/packages/bar.
260
261 =item -j [number]
262
263 =item --jobs [number]
264
265 Run the specified number of jobs in parallel, or an unlimited number of jobs
266 with no number specified. This can greatly speed up operations such as updates.
267 It is not recommended for interactive operations.
268
269 Note that running more than 10 jobs at a time is likely to run afoul of
270 ssh connection limits. Running between 3 and 5 jobs at a time will yield
271 a good speedup in updates without loading the machine too much.
272
273 =item -t
274
275 =item --trust-all
276
277 Trust all mrconfig files even if they are not listed in ~/.mrtrust.
278 Use with caution.
279
280 =item -p
281
282 =item --path
283
284 This obsolete flag is ignored.
285
286 =back
287
288 =head1 MRCONFIG FILES
289
290 Here is an example .mrconfig file:
291
292   [src]
293   checkout = svn checkout svn://svn.example.com/src/trunk src
294   chain = true
295
296   [src/linux-2.6]
297   checkout = git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git &&
298         cd linux-2.6 &&
299         git checkout -b mybranch origin/master
300
301 The .mrconfig file uses a variant of the INI file format. Lines starting with
302 "#" are comments. Values can be continued to the following line by
303 indenting the line with whitespace.
304
305 The "DEFAULT" section allows setting default values for the sections that
306 come after it.
307
308 The "ALIAS" section allows adding aliases for actions. Each parameter
309 is an alias, and its value is the action to use.
310
311 All other sections add repositories. The section header specifies the
312 directory where the repository is located. This is relative to the directory
313 that contains the mrconfig file, but you can also choose to use absolute
314 paths. (Note that you can use environment variables in section names; they
315 will be passed through the shell for expansion. For example, 
316 "[$HOSTNAME]", or "[${HOSTNAME}foo]")
317
318 Within a section, each parameter defines a shell command to run to handle a
319 given action. mr contains default handlers for "update", "status",
320 "commit", and other standard actions.
321
322 Normally you only need to specify what to do for "checkout". Here you
323 specify the command to run in order to create a checkout of the repository.
324 The command will be run in the parent directory, and must create the
325 repository's directory. So use "git clone", "svn checkout", "bzr branch"
326 or "bzr checkout" (for a bound branch), etc.
327
328 Note that these shell commands are run in a "set -e" shell
329 environment, where any additional parameters you pass are available in
330 "$@". All commands other than "checkout" are run inside the repository,
331 though not necessarily at the top of it.
332
333 The "MR_REPO" environment variable is set to the path to the top of the
334 repository. (For the "register" action, "MR_REPO" is instead set to the 
335 basename of the directory that should be created when checking the
336 repository out.)
337
338 The "MR_CONFIG" environment variable is set to the .mrconfig file
339 that defines the repo being acted on, or, if the repo is not yet in a config
340 file, the .mrconfig file that should be modified to register the repo.
341
342 The "MR_ACTION" environment variable is set to the command being run
343 (update, checkout, etc).
344
345 A few parameters have special meanings:
346
347 =over 4
348
349 =item skip
350
351 If the "skip" parameter is set and its command returns true, then B<mr>
352 will skip acting on that repository. The command is passed the action
353 name in $1.
354
355 Here are two examples. The first skips the repo unless
356 mr is run by joey. The second uses the hours_since function
357 (included in mr's built-in library) to skip updating the repo unless it's
358 been at least 12 hours since the last update.
359
360   [mystuff]
361   checkout = ...
362   skip = test `whoami` != joey
363
364   [linux]
365   checkout = ...
366   skip = [ "$1" = update ] && ! hours_since "$1" 12
367  
368 Another way to use skip is for a lazy checkout. This makes mr skip
369 operating on a repo unless it already exists. To enable the 
370 repo, you have to explicitly check it out (using "mr -d foo checkout").
371
372   [foo]
373   checkout = ...
374   skip = lazy
375
376 =item order
377
378 The "order" parameter can be used to override the default ordering of
379 repositories. The default order value is 10. Use smaller values to make
380 repositories be processed earlier, and larger values to make repositories
381 be processed later.
382
383 Note that if a repository is located in a subdirectory of another
384 repository, ordering it to be processed earlier is not recommended.
385
386 =item chain
387
388 If the "chain" parameter is set and its command returns true, then B<mr>
389 will try to load a .mrconfig file from the root of the repository.
390
391 =item include
392
393 If the "include" parameter is set, its command is ran, and should output
394 additional mrconfig file content. The content is included as if it were
395 part of the including file.
396
397 Unlike all other parameters, this parameter does not need to be placed
398 within a section.
399
400 B<mr> ships several libraries that can be included to add support for
401 additional version control type things (unison, git-svn, vcsh, git-fake-bare,
402 git-subtree). To include them all, you could use:
403
404   include = cat /usr/share/mr/*
405
406 See the individual files for details.
407
408 =item deleted
409
410 If the "deleted" parameter is set and its command returns true, then
411 B<mr> will treat the repository as deleted. It won't ever actually delete
412 the repository, but it will warn if it sees the repository's directory.
413 This is useful when one mrconfig file is shared amoung multiple machines,
414 to keep track of and remember to delete old repositories.
415
416 =item lib
417
418 The "lib" parameter can specify some shell code that will be run before each
419 command, this can be a useful way to define shell functions for other commands
420 to use.
421
422 =item fixups
423
424 If the "fixups" parameter is set, its command is run whenever a repository
425 is checked out, or updated. This provides an easy way to do things
426 like permissions fixups, or other tweaks to the repository content,
427 whenever the repository is changed.
428
429 =item pre_ and post_
430
431 If a "pre_action" parameter is set, its command is run before mr performs the
432 specified action. Similarly, "post_action" parameters are run after mr
433 successfully performs the specified action. For example, "pre_commit" is
434 run before committing; "post_update" is run after updating.
435
436 =back
437
438 When looking for a command to run for a given action, mr first looks for
439 a parameter with the same name as the action. If that is not found, it
440 looks for a parameter named "VCS_action" (substituting in the name of the
441 version control system and the action). The name of the version control
442 system is itself determined by running each defined "VCS_test" action,
443 until one succeeds.
444
445 Internally, mr has settings for "git_update", "svn_update", etc. To change
446 the action that is performed for a given version control system, you can
447 override these VCS specific actions. To add a new version control system,
448 you can just add VCS specific actions for it.
449
450 =head1 UNTRUSTED MRCONFIG FILES
451
452 Since mrconfig files can contain arbitrary shell commands, they can do
453 anything. This flexibility is good, but it also allows a malicious mrconfig
454 file to delete your whole home directory. Such a file might be contained
455 inside a repository that your main ~/.mrconfig checks out. To
456 avoid worries about evil commands in a mrconfig file, mr defaults to
457 reading all mrconfig files other than the main ~/.mrconfig in untrusted
458 mode. In untrusted mode, mrconfig files are limited to running only known
459 safe commands (like "git clone") in a carefully checked manner.
460
461 To configure mr to trust other mrconfig files, list them in ~/.mrtrust.
462 One mrconfig file should be listed per line. Either the full pathname
463 should be listed, or the pathname can start with "~/" to specify a file
464 relative to your home directory.
465
466 =head1 OFFLINE LOG FILE
467
468 The ~/.mrlog file contains commands that mr has remembered to run later,
469 due to being offline. You can delete or edit this file to remove commands,
470 or even to add other commands for 'mr online' to run. If the file is
471 present, mr assumes it is in offline mode.
472
473 =head1 EXTENSIONS
474
475 mr can be extended to support things such as unison and git-svn. Some
476 files providing such extensions are available in /usr/share/mr/. See
477 the documentation in the files for details about using them.
478
479 =head1 EXIT STATUS
480
481 mr returns nonzero if a command failed in any of the repositories.
482
483 =head1 AUTHOR
484
485 Copyright 2007-2011 Joey Hess <joey@kitenet.net>
486
487 Licensed under the GNU GPL version 2 or higher.
488
489 http://kitenet.net/~joey/code/mr/
490
491 =cut
492
493 use warnings;
494 use strict;
495 use Getopt::Long;
496 use Cwd qw(getcwd abs_path);
497
498 # things that can happen when mr runs a command
499 use constant {
500         OK => 0,
501         FAILED => 1,
502         SKIPPED => 2,
503         ABORT => 3,
504 };
505
506 # configurables
507 my $config_overridden=0;
508 my $verbose=0;
509 my $quiet=0;
510 my $stats=0;
511 my $insecure=0;
512 my $interactive=0;
513 my $max_depth;
514 my $no_chdir=0;
515 my $jobs=1;
516 my $trust_all=0;
517 my $directory=getcwd();
518
519 $ENV{MR_CONFIG}=find_mrconfig();
520
521 # globals :-(
522 my %config;
523 my %configfiles;
524 my %knownactions;
525 my %alias;
526 my (@ok, @failed, @skipped);
527
528 main();
529
530 my %vcs;
531 sub vcs_test {
532         my ($action, $dir, $topdir, $subdir) = @_;
533
534         if (exists $vcs{$dir}) {
535                 return $vcs{$dir};
536         }
537
538         my $test="set -e\n";
539         foreach my $vcs_test (
540                         sort {
541                                 length $a <=> length $b 
542                                           ||
543                                        $a cmp $b
544                         } grep { /_test$/ } keys %{$config{$topdir}{$subdir}}) {
545                 my ($vcs)=$vcs_test=~/(.*)_test/;
546                 $test="my_$vcs_test() {\n$config{$topdir}{$subdir}{$vcs_test}\n}\n".$test;
547                 $test.="if my_$vcs_test; then echo $vcs; fi\n";
548         }
549         $test=$config{$topdir}{$subdir}{lib}."\n".$test
550                 if exists $config{$topdir}{$subdir}{lib};
551         
552         print "mr $action: running vcs test >>$test<<\n" if $verbose;
553         my $vcs=`$test`;
554         chomp $vcs;
555         if ($vcs=~/\n/s) {
556                 $vcs=~s/\n/, /g;
557                 print STDERR "mr $action: found multiple possible repository types ($vcs) for ".fulldir($topdir, $subdir)."\n";
558                 return undef;
559         }
560         if (! length $vcs) {
561                 return $vcs{$dir}=undef;
562         }
563         else {
564                 return $vcs{$dir}=$vcs;
565         }
566 }
567         
568 sub findcommand {
569         my ($action, $dir, $topdir, $subdir, $is_checkout) = @_;
570         
571         if (exists $config{$topdir}{$subdir}{$action}) {
572                 return $config{$topdir}{$subdir}{$action};
573         }
574
575         if ($is_checkout) {
576                 return undef;
577         }
578
579         my $vcs=vcs_test(@_);
580
581         if (defined $vcs && 
582             exists $config{$topdir}{$subdir}{$vcs."_".$action}) {
583                 return $config{$topdir}{$subdir}{$vcs."_".$action};
584         }
585         else {
586                 return undef;
587         }
588 }
589
590 sub fulldir {
591         my ($topdir, $subdir) = @_;
592         return $subdir =~ /^\// ? $subdir : $topdir.$subdir;
593 }
594
595 sub action {
596         my ($action, $dir, $topdir, $subdir, $force_checkout) = @_;
597         my $fulldir=fulldir($topdir, $subdir);
598
599         $ENV{MR_CONFIG}=$configfiles{$topdir};
600         my $lib=exists $config{$topdir}{$subdir}{lib} ?
601                        $config{$topdir}{$subdir}{lib}."\n" : "";
602         my $is_checkout=($action eq 'checkout');
603         my $is_update=($action =~ /update/);
604
605         $ENV{MR_REPO}=$dir;
606         $ENV{MR_ACTION}=$action;
607         
608         foreach my $testname ("skip", "deleted") {
609                 my $testcommand=findcommand($testname, $dir, $topdir, $subdir, $is_checkout);
610
611                 if (defined $testcommand) {
612                         my $test="set -e;".$lib.
613                                 "my_action(){ $testcommand\n }; my_action '$action'";
614                         print "mr $action: running $testname test >>$test<<\n" if $verbose;
615                         my $ret=system($test);
616                         if ($ret != 0) {
617                                 if (($? & 127) == 2) {
618                                         print STDERR "mr $action: interrupted\n";
619                                         return ABORT;
620                                 }
621                                 elsif ($? & 127) {
622                                         print STDERR "mr $action: $testname test received signal ".($? & 127)."\n";
623                                         return ABORT;
624                                 }
625                         }
626                         if ($ret >> 8 == 0) {
627                                 if ($testname eq "deleted") {
628                                         if (-d $dir) {
629                                                 print STDERR "mr error: $dir should be deleted yet still exists\n";
630                                                 return FAILED;
631                                         }
632                                 }
633                                 print "mr $action: skip $dir skipped\n" if $verbose;
634                                 return SKIPPED;
635                         }
636                 }
637         }
638
639         if ($is_checkout) {
640                 if (! $force_checkout) {
641                         if (-d $dir) {
642                                 print "mr $action: $dir already exists, skipping checkout\n" if $verbose;
643                                 return SKIPPED;
644                         }
645         
646                         $dir=~s/^(.*)\/[^\/]+\/?$/$1/;
647                 }
648         }
649         elsif ($is_update) {
650                 if (! -d $dir) {
651                         return action("checkout", $dir, $topdir, $subdir);
652                 }
653         }
654
655         my $command=findcommand($action, $dir, $topdir, $subdir, $is_checkout);
656
657         if ($is_checkout && ! -d $dir) {
658                 print "mr $action: creating parent directory $dir\n" if $verbose;
659                 system("mkdir", "-p", $dir);
660         }
661
662         if (! $no_chdir && ! chdir($dir)) {
663                 print STDERR "mr $action: failed to chdir to $dir: $!\n";
664                 return FAILED;
665         }
666         elsif (! defined $command) {
667                 my $vcs=vcs_test(@_);
668                 if (! defined $vcs) {
669                         print STDERR "mr $action: unknown repository type and no defined $action command for $fulldir\n";
670                         return FAILED;
671                 }
672                 else {
673                         print STDERR "mr $action: no defined action for $vcs repository $fulldir, skipping\n";
674                         return SKIPPED;
675                 }
676         }
677         else {
678                 my $actionmsg;
679                 if (! $no_chdir) {
680                         $actionmsg="mr $action: $fulldir";
681                 }
682                 else {
683                         my $s=$directory;
684                         $s=~s/^\Q$fulldir\E\/?//;
685                         $actionmsg="mr $action: $fulldir (in subdir $s)";
686                 }
687                 print "$actionmsg\n" unless $quiet;
688
689                 my $hookret=hook("pre_$action", $topdir, $subdir);
690                 return $hookret if $hookret != OK;
691
692                 $command="set -e; ".$lib.
693                         "my_action(){ $command\n }; my_action ".
694                         join(" ", map { s/\\/\\\\/g; s/"/\"/g; '"'.$_.'"' } @ARGV);
695                 print "mr $action: running >>$command<<\n" if $verbose;
696                 my $ret;
697                 if ($quiet) {
698                         my $output = qx/$command 2>&1/;
699                         $ret = $?;
700                         if ($ret != 0) {
701                                 print "$actionmsg\n";
702                                 print STDERR $output;
703                         }
704                 }
705                 else {
706                         $ret=system($command);
707                 }
708                 if ($ret != 0) {
709                         if (($? & 127) == 2) {
710                                 print STDERR "mr $action: interrupted\n";
711                                 return ABORT;
712                         }
713                         elsif ($? & 127) {
714                                 print STDERR "mr $action: received signal ".($? & 127)."\n";
715                                 return ABORT;
716                         }
717                         print STDERR "mr $action: failed ($ret)\n" if $verbose;
718                         if ($ret >> 8 != 0) {
719                                 print STDERR "mr $action: command failed\n";
720                                 if (-e "$ENV{HOME}/.mrlog" && $action ne 'remember') {
721                                         # recreate original command line to
722                                         # remember, and avoid recursing
723                                         my @orig=@ARGV;
724                                         @ARGV=('-n', $action, @orig);
725                                         action("remember", $dir, $topdir, $subdir);
726                                         @ARGV=@orig;
727                                 }
728                         }
729                         elsif ($ret != 0) {
730                                 print STDERR "mr $action: command died ($ret)\n";
731                         }
732                         return FAILED;
733                 }
734                 else {
735                         if ($is_checkout && ! -d $dir) {
736                                 print STDERR "mr $action: $dir missing after checkout\n";;
737                                 return FAILED;
738                         }
739
740                         my $ret=hook("post_$action", $topdir, $subdir);
741                         return $ret if $ret != OK;
742                         
743                         if (($is_checkout || $is_update)) {
744                                 my $ret=hook("fixups", $topdir, $subdir);
745                                 return $ret if $ret != OK;
746                         }
747                         
748                         return OK;
749                 }
750         }
751 }
752
753 sub hook {
754         my ($hook, $topdir, $subdir) = @_;
755
756         my $command=$config{$topdir}{$subdir}{$hook};
757         return OK unless defined $command;
758         my $lib=exists $config{$topdir}{$subdir}{lib} ?
759                        $config{$topdir}{$subdir}{lib}."\n" : "";
760         my $shell="set -e;".$lib.
761                 "my_hook(){ $command\n }; my_hook";
762         print "mr $hook: running >>$shell<<\n" if $verbose;
763         my $ret;
764         if ($quiet) {
765                 my $output = qx/$shell 2>&1/;
766                 $ret = $?;
767                 if ($ret != 0) {
768                         print STDERR $output;
769                 }
770         }
771         else {
772                 $ret=system($shell);
773         }
774         if ($ret != 0) {
775                 if (($? & 127) == 2) {
776                         print STDERR "mr $hook: interrupted\n";
777                         return ABORT;
778                 }
779                 elsif ($? & 127) {
780                         print STDERR "mr $hook: received signal ".($? & 127)."\n";
781                         return ABORT;
782                 }
783                 else {
784                         return FAILED;
785                 }
786         }
787
788         return OK;
789 }
790
791 # run actions on multiple repos, in parallel
792 sub mrs {
793         my $action=shift;
794         my @repos=@_;
795
796         $| = 1;
797         my @active;
798         my @fhs;
799         my @out;
800         my $running=0;
801         while (@fhs or @repos) {
802                 while ((!$jobs || $running < $jobs) && @repos) {
803                         $running++;
804                         my $repo = shift @repos;
805                         pipe(my $outfh, CHILD_STDOUT);
806                         pipe(my $errfh, CHILD_STDERR);
807                         my $pid;
808                         unless ($pid = fork) {
809                                 die "mr $action: cannot fork: $!" unless defined $pid;
810                                 open(STDOUT, ">&CHILD_STDOUT") || die "mr $action cannot reopen stdout: $!";
811                                 open(STDERR, ">&CHILD_STDERR") || die "mr $action cannot reopen stderr: $!";
812                                 close CHILD_STDOUT;
813                                 close CHILD_STDERR;
814                                 close $outfh;
815                                 close $errfh;
816                                 exit action($action, @$repo);
817                         }
818                         close CHILD_STDOUT;
819                         close CHILD_STDERR;
820                         push @active, [$pid, $repo];
821                         push @fhs, [$outfh, $errfh];
822                         push @out, ['',     ''];
823                 }
824                 my ($rin, $rout) = ('','');
825                 my $nfound;
826                 foreach my $fh (@fhs) {
827                         next unless defined $fh;
828                         vec($rin, fileno($fh->[0]), 1) = 1 if defined $fh->[0];
829                         vec($rin, fileno($fh->[1]), 1) = 1 if defined $fh->[1];
830                 }
831                 $nfound = select($rout=$rin, undef, undef, 1);
832                 foreach my $channel (0, 1) {
833                         foreach my $i (0..$#fhs) {
834                                 next unless defined $fhs[$i];
835                                 my $fh = $fhs[$i][$channel];
836                                 next unless defined $fh;
837                                 if (vec($rout, fileno($fh), 1) == 1) {
838                                         my $r = '';
839                                         if (sysread($fh, $r, 1024) == 0) {
840                                                 close($fh);
841                                                 $fhs[$i][$channel] = undef;
842                                                 if (! defined $fhs[$i][0] &&
843                                                     ! defined $fhs[$i][1]) {
844                                                         waitpid($active[$i][0], 0);
845                                                         print STDOUT $out[$i][0];
846                                                         print STDERR $out[$i][1];
847                                                         record($active[$i][1], $? >> 8);
848                                                         splice(@fhs, $i, 1);
849                                                         splice(@active, $i, 1);
850                                                         splice(@out, $i, 1);
851                                                         $running--;
852                                                 }
853                                         }
854                                         $out[$i][$channel] .= $r;
855                                 }
856                         }
857                 }
858         }
859 }
860
861 sub record {
862         my $dir=shift()->[0];
863         my $ret=shift;
864
865         if ($ret == OK) {
866                 push @ok, $dir;
867                 print "\n" unless $quiet;
868         }
869         elsif ($ret == FAILED) {
870                 if ($interactive) {
871                         chdir($dir) unless $no_chdir;
872                         print STDERR "mr: Starting interactive shell. Exit shell to continue.\n";
873                         system((getpwuid($<))[8], "-i");
874                 }
875                 push @failed, $dir;
876                 print "\n" unless $quiet;
877         }
878         elsif ($ret == SKIPPED) {
879                 push @skipped, $dir;
880         }
881         elsif ($ret == ABORT) {
882                 exit 1;
883         }
884         else {
885                 die "unknown exit status $ret";
886         }
887 }
888
889 sub showstats {
890         my $action=shift;
891         if (! @ok && ! @failed && ! @skipped) {
892                 die "mr $action: no repositories found to work on\n";
893         }
894         print "mr $action: finished (".join("; ",
895                 showstat($#ok+1, "ok", "ok"),
896                 showstat($#failed+1, "failed", "failed"),
897                 showstat($#skipped+1, "skipped", "skipped"),
898         ).")\n" unless $quiet;
899         if ($stats) {
900                 if (@skipped) {
901                         print "mr $action: (skipped: ".join(" ", @skipped).")\n" unless $quiet;
902                 }
903                 if (@failed) {
904                         print STDERR "mr $action: (failed: ".join(" ", @failed).")\n";
905                 }
906         }
907 }
908
909 sub showstat {
910         my $count=shift;
911         my $singular=shift;
912         my $plural=shift;
913         if ($count) {
914                 return "$count ".($count > 1 ? $plural : $singular);
915         }
916         return;
917 }
918
919 # an ordered list of repos
920 sub repolist {
921         my @list;
922         foreach my $topdir (sort keys %config) {
923                 foreach my $subdir (sort keys %{$config{$topdir}}) {
924                         push @list, {
925                                 topdir => $topdir,
926                                 subdir => $subdir,
927                                 order => $config{$topdir}{$subdir}{order},
928                         };
929                 }
930         }
931         return sort {
932                 $a->{order}  <=> $b->{order}
933                              ||
934                 $a->{topdir} cmp $b->{topdir}
935                              ||
936                 $a->{subdir} cmp $b->{subdir}
937         } @list;
938 }
939
940 sub repodir {
941         my $repo=shift;
942         my $topdir=$repo->{topdir};
943         my $subdir=$repo->{subdir};
944         my $ret=($subdir =~/^\//) ? $subdir : $topdir.$subdir;
945         $ret=~s/\/\.$//;
946         return $ret;
947 }
948
949 # figure out which repos to act on
950 sub selectrepos {
951         my @repos;
952         foreach my $repo (repolist()) {
953                 my $topdir=$repo->{topdir};
954                 my $subdir=$repo->{subdir};
955
956                 next if $subdir eq 'DEFAULT';
957                 my $dir=repodir($repo);
958                 my $d=$directory;
959                 $dir.="/" unless $dir=~/\/$/;
960                 $d.="/" unless $d=~/\/$/;
961                 next if $dir ne $d && $dir !~ /^\Q$d\E/;
962                 if (defined $max_depth) {
963                         my @a=split('/', $dir);
964                         my @b=split('/', $d);
965                         do { } while (@a && @b && shift(@a) eq shift(@b));
966                         next if @a > $max_depth || @b > $max_depth;
967                 }
968                 push @repos, [$dir, $topdir, $subdir];
969         }
970         if (! @repos) {
971                 # fallback to find a leaf repo
972                 foreach my $repo (reverse repolist()) {
973                         my $topdir=$repo->{topdir};
974                         my $subdir=$repo->{subdir};
975                         
976                         next if $subdir eq 'DEFAULT';
977                         my $dir=repodir($repo);
978                         my $d=$directory;
979                         $dir.="/" unless $dir=~/\/$/;
980                         $d.="/" unless $d=~/\/$/;
981                         if ($d=~/^\Q$dir\E/) {
982                                 push @repos, [$dir, $topdir, $subdir];
983                                 last;
984                         }
985                 }
986                 $no_chdir=1;
987         }
988         return @repos;
989 }
990
991 sub expandenv {
992         my $val=shift;
993         
994
995         if ($val=~/\$/) {
996                 $val=`echo "$val"`;
997                 chomp $val;
998         }
999         
1000         return $val;
1001 }
1002
1003 my %trusted;
1004 sub is_trusted_config {
1005         my $config=shift; # must be abs_pathed already
1006
1007         # We always trust ~/.mrconfig.
1008         return 1 if $config eq abs_path("$ENV{HOME}/.mrconfig");
1009
1010         return 1 if $trust_all;
1011
1012         my $trustfile=$ENV{HOME}."/.mrtrust";
1013
1014         if (! %trusted) {
1015                 $trusted{"$ENV{HOME}/.mrconfig"}=1;
1016                 if (open (TRUST, "<", $trustfile)) {
1017                         while (<TRUST>) {
1018                                 chomp;
1019                                 s/^~\//$ENV{HOME}\//;
1020                                 $trusted{abs_path($_)}=1;
1021                         }
1022                         close TRUST;
1023                 }
1024         }
1025
1026         return $trusted{$config};
1027 }
1028
1029
1030 sub is_trusted_repo {
1031         my $repo=shift;
1032         
1033         # Tightly limit what is allowed in a repo name.
1034         # No ../, no absolute paths, and no unusual filenames
1035         # that might try to escape to the shell.
1036         return $repo =~ /^[-_.+\/A-Za-z0-9]+$/ &&
1037                $repo !~ /\.\./ && $repo !~ /^\//;
1038 }
1039
1040 sub is_trusted_checkout {
1041         my $command=shift;
1042         
1043         # To determine if the command is safe, compare it with the
1044         # *_trusted_checkout config settings. Those settings are
1045         # templates for allowed commands, so make sure that each word
1046         # of the command matches the corresponding word of the template.
1047         
1048         my @words;
1049         foreach my $word (split(' ', $command)) {
1050                 # strip quoting
1051                 if ($word=~/^'(.*)'$/) {
1052                         $word=$1;
1053                 }
1054                 elsif ($word=~/^"(.*)"$/) {
1055                         $word=$1;
1056                 }
1057
1058                 push @words, $word;
1059         }
1060
1061         foreach my $key (grep { /_trusted_checkout$/ }
1062                          keys %{$config{''}{DEFAULT}}) {
1063                 my @twords=split(' ', $config{''}{DEFAULT}{$key});
1064                 next if @words > @twords;
1065
1066                 my $match=1;
1067                 my $url;
1068                 for (my $c=0; $c < @twords && $match; $c++) {
1069                         if ($twords[$c] eq '$url') {
1070                                 # Match all the typical characters found in
1071                                 # urls, plus @ which svn can use. Note
1072                                 # that the "url" might also be a local
1073                                 # directory.
1074                                 $match=(
1075                                         defined $words[$c] &&
1076                                         $words[$c] =~ /^[-_.+:@\/A-Za-z0-9]+$/
1077                                 );
1078                                 $url=$words[$c];
1079                         }
1080                         elsif ($twords[$c] eq '$repo') {
1081                                 # If a repo is not specified, assume it
1082                                 # will be the last path component of the
1083                                 # url, or something derived from it, and
1084                                 # check that.
1085                                 if (! defined $words[$c] && defined $url) {
1086                                         ($words[$c])=$url=~/\/([^\/]+)\/?$/;
1087                                 }
1088
1089                                 $match=(
1090                                         defined $words[$c] &&
1091                                         is_trusted_repo($words[$c])
1092                                 );
1093                         }
1094                         elsif (defined $words[$c] && $words[$c]=~/^($twords[$c])$/) {
1095                                 $match=1;
1096                         }
1097                         else {
1098                                 $match=0;
1099                         }
1100                 }
1101                 return 1 if $match;
1102         }
1103
1104         return 0;
1105 }
1106
1107 sub trusterror {
1108         my ($err, $file, $line, $url)=@_;
1109         
1110         if (defined $url) {
1111                 die "$err in untrusted $url line $line\n".
1112                         "(To trust this url, --trust-all can be used; but please use caution;\n".
1113                         "this can allow arbitrary code execution!)\n";
1114         }
1115         else {
1116                 die "$err in untrusted $file line $line\n".
1117                         "(To trust this file, list it in ~/.mrtrust.)\n";
1118         }
1119 }
1120
1121 my %loaded;
1122 sub loadconfig {
1123         my $f=shift;
1124         my $dir=shift;
1125         my $bootstrap_url=shift;
1126
1127         my @toload;
1128
1129         my $in;
1130         my $trusted;
1131         if (ref $f eq 'GLOB') {
1132                 $dir="";
1133                 $in=$f;
1134                 $trusted=1;
1135         }
1136         else {
1137                 my $absf=abs_path($f);
1138                 if ($loaded{$absf}) {
1139                         return;
1140                 }
1141                 $loaded{$absf}=1;
1142
1143                 $trusted=is_trusted_config($absf);
1144
1145                 if (! defined $dir) {
1146                         ($dir)=$f=~/^(.*\/)[^\/]+$/;
1147                         if (! defined $dir) {
1148                                 $dir=".";
1149                         }
1150                 }
1151
1152                 $dir=abs_path($dir)."/";
1153                 
1154                 if (! exists $configfiles{$dir}) {
1155                         $configfiles{$dir}=$f;
1156                 }
1157
1158                 # copy in defaults from first parent
1159                 my $parent=$dir;
1160                 while ($parent=~s/^(.*\/)[^\/]+\/?$/$1/) {
1161                         if ($parent eq '/') {
1162                                 $parent="";
1163                         }
1164                         if (exists $config{$parent} &&
1165                             exists $config{$parent}{DEFAULT}) {
1166                                 $config{$dir}{DEFAULT}={ %{$config{$parent}{DEFAULT}} };
1167                                 last;
1168                         }
1169                 }
1170                 
1171                 if (! -e $f) {
1172                         return;
1173                 }
1174
1175                 print "mr: loading config $f\n" if $verbose;
1176                 open($in, "<", $f) || die "mr: open $f: $!\n";
1177         }
1178         my @lines=<$in>;
1179         close $in unless ref $f eq 'GLOB';
1180
1181         my $section;
1182
1183         # Keep track of the current line in the config file;
1184         # when a file is included track the current line from the include.
1185         my $line=0;
1186         my $included=undef;
1187         my $includeline=0;
1188         my $nextline = sub {
1189                 if ($included) {
1190                         $includeline++;
1191                         $included--;
1192                 }
1193                 else {
1194                         $included=undef;
1195                         $includeline=0;
1196                         $line++;
1197                 }
1198                 my $l=shift @lines;
1199                 chomp $l;
1200                 return $l
1201         };
1202         my $lineerror = sub {
1203                 my $msg=shift;
1204                 if (defined $included) {
1205                         die "mr: $f line $line include line $includeline: $msg\n";
1206                 }
1207                 else {
1208                         die "mr: $f line $line: $msg\n";
1209                 }
1210         };
1211
1212         while (@lines) {
1213                 $_=$nextline->();
1214
1215                 if (! $trusted && /[[:cntrl:]]/) {
1216                         trusterror("mr: illegal control character", $f, $line, $bootstrap_url);
1217                 }
1218
1219                 next if /^\s*\#/ || /^\s*$/;
1220                 if (/^\[([^\]]*)\]\s*$/) {
1221                         $section=$1;
1222
1223                         if (! $trusted) {
1224                                 if (! is_trusted_repo($section) ||
1225                                     $section eq 'ALIAS' ||
1226                                     $section eq 'DEFAULT') {
1227                                         trusterror("mr: illegal section \"[$section]\"", $f, $line, $bootstrap_url)
1228                                 }
1229                         }
1230                         $section=expandenv($section) if $trusted;
1231                         if ($section ne 'ALIAS' &&
1232                             ! exists $config{$dir}{$section} &&
1233                             exists $config{$dir}{DEFAULT}) {
1234                                 # copy in defaults
1235                                 $config{$dir}{$section}={ %{$config{$dir}{DEFAULT}} };
1236                         }
1237                 }
1238                 elsif (/^(\w+)\s*=\s*(.*)/) {
1239                         my $parameter=$1;
1240                         my $value=$2;
1241
1242                         # continued value
1243                         while (@lines && $lines[0]=~/^\s(.+)/) {
1244                                 $value.="\n$1";
1245                                 chomp $value;
1246                                 $nextline->();
1247                         }
1248
1249                         if (! $trusted) {
1250                                 # Untrusted files can only contain a few
1251                                 # settings in specific known-safe formats.
1252                                 if ($parameter eq 'checkout') {
1253                                         if (! is_trusted_checkout($value)) {
1254                                                 trusterror("mr: illegal checkout command \"$value\"", $f, $line, $bootstrap_url);
1255                                         }
1256                                 }
1257                                 elsif ($parameter eq 'order') {
1258                                         # not interpreted as a command, so
1259                                         # safe.
1260                                 }
1261                                 elsif ($value eq 'true' || $value eq 'false') {
1262                                         # skip=true , deleted=true etc are
1263                                         # safe.
1264                                 }
1265                                 else {
1266                                         trusterror("mr: illegal setting \"$parameter=$value\"", $f, $line, $bootstrap_url);
1267                                 }
1268                         }
1269
1270                         if ($parameter eq "include") {
1271                                 print "mr: including output of \"$value\"\n" if $verbose;
1272                                 my @inc=`$value`;
1273                                 if ($?) {
1274                                         print STDERR "mr: include command exited nonzero ($?)\n";
1275                                 }
1276                                 $included += @inc;
1277                                 unshift @lines, @inc;
1278                                 next;
1279                         }
1280
1281                         if (! defined $section) {
1282                                 $lineerror->("parameter ($parameter) not in section");
1283                         }
1284                         if ($section eq 'ALIAS') {
1285                                 $alias{$parameter}=$value;
1286                         }
1287                         elsif ($parameter eq 'lib') {
1288                                 $config{$dir}{$section}{lib}.=$value."\n";
1289                         }
1290                         else {
1291                                 $config{$dir}{$section}{$parameter}=$value;
1292                                 if ($parameter =~ /.*_(.*)/) {
1293                                         $knownactions{$1}=1;
1294                                 }
1295                                 else {
1296                                         $knownactions{$parameter}=1;
1297                                 }
1298                                 if ($parameter eq 'chain' &&
1299                                     length $dir && $section ne "DEFAULT") {
1300                                         my $chaindir="$section";
1301                                         if ($chaindir !~ m!^/!) {
1302                                                 $chaindir=$dir.$chaindir;
1303                                         }
1304                                         if (-e "$chaindir/.mrconfig") {
1305                                                 my $ret=system($value);
1306                                                 if ($ret != 0) {
1307                                                         if (($? & 127) == 2) {
1308                                                                 print STDERR "mr: chain test interrupted\n";
1309                                                                 exit 2;
1310                                                         }
1311                                                         elsif ($? & 127) {
1312                                                                 print STDERR "mr: chain test received signal ".($? & 127)."\n";
1313                                                         }
1314                                                 }
1315                                                 else {
1316                                                         push @toload, ["$chaindir/.mrconfig", $chaindir];
1317                                                 }
1318                                         }
1319                                 }
1320                         }
1321                 }
1322                 else {
1323                         $lineerror->("parse error");
1324                 }
1325         }
1326
1327         foreach my $c (@toload) {
1328                 loadconfig(@$c);
1329         }
1330 }
1331
1332 sub startingconfig {
1333         %alias=%config=%configfiles=%knownactions=%loaded=();
1334         my $datapos=tell(DATA);
1335         loadconfig(\*DATA);
1336         seek(DATA,$datapos,0); # rewind
1337 }
1338
1339 sub modifyconfig {
1340         my $f=shift;
1341         # the section to modify or add
1342         my $targetsection=shift;
1343         # fields to change in the section
1344         # To remove a field, set its value to "".
1345         my %changefields=@_;
1346
1347         my @lines;
1348         my @out;
1349
1350         if (-e $f) {
1351                 open(my $in, "<", $f) || die "mr: open $f: $!\n";
1352                 @lines=<$in>;
1353                 close $in;
1354         }
1355
1356         my $formatfield=sub {
1357                 my $field=shift;
1358                 my @value=split(/\n/, shift);
1359
1360                 return "$field = ".shift(@value)."\n".
1361                         join("", map { "\t$_\n" } @value);
1362         };
1363         my $addfields=sub {
1364                 my @blanks;
1365                 while ($out[$#out] =~ /^\s*$/) {
1366                         unshift @blanks, pop @out;
1367                 }
1368                 foreach my $field (sort keys %changefields) {
1369                         if (length $changefields{$field}) {
1370                                 push @out, "$field = $changefields{$field}\n";
1371                                 delete $changefields{$field};
1372                         }
1373                 }
1374                 push @out, @blanks;
1375         };
1376
1377         my $section;
1378         while (@lines) {
1379                 $_=shift(@lines);
1380
1381                 if (/^\s*\#/ || /^\s*$/) {
1382                         push @out, $_;
1383                 }
1384                 elsif (/^\[([^\]]*)\]\s*$/) {
1385                         if (defined $section && 
1386                             $section eq $targetsection) {
1387                                 $addfields->();
1388                         }
1389
1390                         $section=expandenv($1);
1391
1392                         push @out, $_;
1393                 }
1394                 elsif (/^(\w+)\s*=\s(.*)/) {
1395                         my $parameter=$1;
1396                         my $value=$2;
1397
1398                         # continued value
1399                         while (@lines && $lines[0]=~/^\s(.+)/) {
1400                                 shift(@lines);
1401                                 $value.="\n$1";
1402                                 chomp $value;
1403                         }
1404
1405                         if ($section eq $targetsection) {
1406                                 if (exists $changefields{$parameter}) {
1407                                         if (length $changefields{$parameter}) {
1408                                                 $value=$changefields{$parameter};
1409                                         }
1410                                         delete $changefields{$parameter};
1411                                 }
1412                         }
1413
1414                         push @out, $formatfield->($parameter, $value);
1415                 }
1416         }
1417
1418         if (defined $section && 
1419             $section eq $targetsection) {
1420                 $addfields->();
1421         }
1422         elsif (%changefields) {
1423                 push @out, "\n[$targetsection]\n";
1424                 foreach my $field (sort keys %changefields) {
1425                         if (length $changefields{$field}) {
1426                                 push @out, $formatfield->($field, $changefields{$field});
1427                         }
1428                 }
1429         }
1430
1431         open(my $out, ">", $f) || die "mr: write $f: $!\n";
1432         print $out @out;
1433         close $out;     
1434 }
1435
1436 sub dispatch {
1437         my $action=shift;
1438
1439         # actions that do not operate on all repos
1440         if ($action eq 'help') {
1441                 help(@ARGV);
1442         }
1443         elsif ($action eq 'config') {
1444                 config(@ARGV);
1445         }
1446         elsif ($action eq 'register') {
1447                 register(@ARGV);
1448         }
1449         elsif ($action eq 'bootstrap') {
1450                 bootstrap();
1451         }
1452         elsif ($action eq 'remember' ||
1453                $action eq 'offline' ||
1454                $action eq 'online') {
1455                 my @repos=selectrepos;
1456                 action($action, @{$repos[0]}) if @repos;
1457                 exit 0;
1458         }
1459
1460         if (!$jobs || $jobs > 1) {
1461                 mrs($action, selectrepos());
1462         }
1463         else {
1464                 foreach my $repo (selectrepos()) {
1465                         record($repo, action($action, @$repo));
1466                 }
1467         }
1468 }
1469
1470 sub help {
1471         exec($config{''}{DEFAULT}{help}) || die "exec: $!";
1472 }
1473
1474 sub config {
1475         if (@_ < 2) {
1476                 die "mr config: not enough parameters\n";
1477         }
1478         my $section=shift;
1479         if ($section=~/^\//) {
1480                 # try to convert to a path relative to the config file
1481                 my ($dir)=$ENV{MR_CONFIG}=~/^(.*\/)[^\/]+$/;
1482                 $dir=abs_path($dir);
1483                 $dir.="/" unless $dir=~/\/$/;
1484                 if ($section=~/^\Q$dir\E(.*)/) {
1485                         $section=$1;
1486                 }
1487         }
1488         my %changefields;
1489         foreach (@_) {
1490                 if (/^([^=]+)=(.*)$/) {
1491                         $changefields{$1}=$2;
1492                 }
1493                 else {
1494                         my $found=0;
1495                         foreach my $topdir (sort keys %config) {
1496                                 if (exists $config{$topdir}{$section} &&
1497                                     exists $config{$topdir}{$section}{$_}) {
1498                                         print $config{$topdir}{$section}{$_}."\n";
1499                                         $found=1;
1500                                         last if $section eq 'DEFAULT';
1501                                 }
1502                         }
1503                         if (! $found) {
1504                                 die "mr config: $section $_ not set\n";
1505                         }
1506                 }
1507         }
1508         modifyconfig($ENV{MR_CONFIG}, $section, %changefields) if %changefields;
1509         exit 0;
1510 }
1511
1512 sub register {
1513         if ($config_overridden) {
1514                 # Find the directory that the specified config file is
1515                 # located in.
1516                 ($directory)=abs_path($ENV{MR_CONFIG})=~/^(.*\/)[^\/]+$/;
1517         }
1518         else {
1519                 # Find the closest known mrconfig file to the current
1520                 # directory.
1521                 $directory.="/" unless $directory=~/\/$/;
1522                 my $foundconfig=0;
1523                 foreach my $topdir (reverse sort keys %config) {
1524                         next unless length $topdir;
1525                         if ($directory=~/^\Q$topdir\E/) {
1526                                 $ENV{MR_CONFIG}=$configfiles{$topdir};
1527                                 $directory=$topdir;
1528                                 $foundconfig=1;
1529                                 last;
1530                         }
1531                 }
1532                 if (! $foundconfig) {
1533                         $directory=""; # no config file, use builtin
1534                 }
1535         }
1536         if (@ARGV) {
1537                 my $subdir=shift @ARGV;
1538                 if (! chdir($subdir)) {
1539                         print STDERR "mr register: failed to chdir to $subdir: $!\n";
1540                 }
1541         }
1542
1543         $ENV{MR_REPO}=getcwd();
1544         my $command=findcommand("register", $ENV{MR_REPO}, $directory, 'DEFAULT', 0);
1545         if (! defined $command) {
1546                 die "mr register: unknown repository type\n";
1547         }
1548
1549         $ENV{MR_REPO}=~s/.*\/(.*)/$1/;
1550         $command="set -e; ".$config{$directory}{DEFAULT}{lib}."\n".
1551                 "my_action(){ $command\n }; my_action ".
1552                 join(" ", map { s/\\/\\\\/g; s/"/\"/g; '"'.$_.'"' } @ARGV);
1553         print "mr register: running >>$command<<\n" if $verbose;
1554         exec($command) || die "exec: $!";
1555 }
1556
1557 sub bootstrap {
1558         my $url=shift @ARGV;
1559         my $dir=shift @ARGV || ".";
1560         
1561         if (! defined $url || ! length $url) {
1562                 die "mr: bootstrap requires url\n";
1563         }
1564         
1565         # Download the config file to a temporary location.
1566         eval q{use File::Temp};
1567         die $@ if $@;
1568         my $tmpconfig=File::Temp->new();
1569         my @curlargs = ("curl", "-A", "mr", "-L", "-s", $url, "-o", $tmpconfig);
1570         push(@curlargs, "-k") if $insecure;
1571         my $curlstatus = system(@curlargs);
1572         die "mr bootstrap: invalid SSL certificate for $url (consider -k)\n" if $curlstatus >> 8 == 60;
1573         die "mr bootstrap: download of $url failed\n" if $curlstatus != 0;
1574
1575         if (! -e $dir) {
1576                 system("mkdir", "-p", $dir);
1577         }
1578         chdir($dir) || die "chdir $dir: $!";
1579
1580         # Special case to handle checkout of the "." repo, which 
1581         # would normally be skipped.
1582         my $topdir=abs_path(".")."/";
1583         my @repo=($topdir, $topdir, ".");
1584         loadconfig($tmpconfig, $topdir, $url);
1585         record(\@repo, action("checkout", @repo, 1))
1586                 if exists $config{$topdir}{"."}{"checkout"};
1587
1588         if (-e ".mrconfig") {
1589                 print STDERR "mr bootstrap: .mrconfig file already exists, not overwriting with $url\n";
1590         }
1591         else {
1592                 eval q{use File::Copy};
1593                 die $@ if $@;
1594                 move($tmpconfig, ".mrconfig") || die "rename: $!";
1595         }
1596
1597         # Reload the config file (in case we got a different version)
1598         # and checkout everything else.
1599         startingconfig();
1600         loadconfig(".mrconfig");
1601         dispatch("checkout");
1602         @skipped=grep { abs_path($_) ne abs_path($topdir) } @skipped;
1603         showstats("bootstrap");
1604         exitstats();
1605 }
1606
1607 # alias expansion and command stemming
1608 sub expandaction {
1609         my $action=shift;
1610         if (exists $alias{$action}) {
1611                 $action=$alias{$action};
1612         }
1613         if (! exists $knownactions{$action}) {
1614                 my @matches = grep { /^\Q$action\E/ }
1615                         keys %knownactions, keys %alias;
1616                 if (@matches == 1) {
1617                         $action=$matches[0];
1618                 }
1619                 elsif (@matches == 0) {
1620                         die "mr: unknown action \"$action\" (known actions: ".
1621                                 join(", ", sort keys %knownactions).")\n";
1622                 }
1623                 else {
1624                         die "mr: ambiguous action \"$action\" (matches: ".
1625                                 join(", ", @matches).")\n";
1626                 }
1627         }
1628         return $action;
1629 }
1630
1631 sub find_mrconfig {
1632         my $dir=getcwd();
1633         while (length $dir) {
1634                 if (-e "$dir/.mrconfig") {
1635                         return "$dir/.mrconfig";
1636                 }
1637                 $dir=~s/\/[^\/]*$//;
1638         }
1639         return "$ENV{HOME}/.mrconfig";
1640 }
1641
1642 sub getopts {
1643         my @saved=@ARGV;
1644         Getopt::Long::Configure("bundling", "no_permute");
1645         my $result=GetOptions(
1646                 "d|directory=s" => sub { $directory=abs_path($_[1]) },
1647                 "c|config=s" => sub { $ENV{MR_CONFIG}=$_[1]; $config_overridden=1 },
1648                 "p|path" => sub { }, # now default, ignore
1649                 "v|verbose" => \$verbose,
1650                 "q|quiet" => \$quiet,
1651                 "s|stats" => \$stats,
1652                 "k|insecure" => \$insecure,
1653                 "i|interactive" => \$interactive,
1654                 "n|no-recurse:i" => \$max_depth,
1655                 "j|jobs:i" => \$jobs,
1656                 "t|trust-all" => \$trust_all,
1657         );
1658         if (! $result || @ARGV < 1) {
1659                 die("Usage: mr [options] action [params ...]\n".
1660                     "(Use mr help for man page.)\n");
1661         }
1662         
1663         $ENV{MR_SWITCHES}="";
1664         foreach my $option (@saved) {
1665                 last if $option eq $ARGV[0];
1666                 $ENV{MR_SWITCHES}.="$option ";
1667         }
1668 }
1669
1670 sub init {
1671         $SIG{INT}=sub {
1672                 print STDERR "mr: interrupted\n";
1673                 exit 2;
1674         };
1675         
1676         # This can happen if it's run in a directory that was removed
1677         # or other strangeness.
1678         if (! defined $directory) {
1679                 die("mr: failed to determine working directory\n");
1680         }
1681         # Make sure MR_CONFIG is an absolute path, but don't use abs_path since
1682         # the config file might be a symlink to elsewhere, and the directory it's
1683         # in is significant.
1684         if ($ENV{MR_CONFIG} !~ /^\//) {
1685                 $ENV{MR_CONFIG}=getcwd()."/".$ENV{MR_CONFIG};
1686         }
1687         # Try to set MR_PATH to the path to the program.
1688         eval {
1689                 use FindBin qw($Bin $Script);
1690                 $ENV{MR_PATH}=$Bin."/".$Script;
1691         };
1692 }
1693         
1694 sub exitstats {
1695         if (@failed) {
1696                 exit 1;
1697         }
1698         else {
1699                 exit 0;
1700         }
1701 }
1702
1703 sub main {
1704         getopts();
1705         init();
1706
1707         startingconfig();
1708         loadconfig("$ENV{HOME}/.mrconfig");
1709         loadconfig($ENV{MR_CONFIG});
1710         #use Data::Dumper; print Dumper(\%config);
1711         
1712         my $action=expandaction(shift @ARGV);
1713         dispatch($action);
1714
1715         showstats($action);
1716         exitstats();
1717 }
1718
1719 # Finally, some useful actions that mr knows about by default.
1720 # These can be overridden in ~/.mrconfig.
1721 __DATA__
1722 [ALIAS]
1723 co = checkout
1724 ci = commit
1725 ls = list
1726
1727 [DEFAULT]
1728 order = 10
1729 lib =
1730         error() {
1731                 echo "mr: $@" >&2
1732                 exit 1
1733         }
1734         warning() {
1735                 echo "mr (warning): $@" >&2
1736         }
1737         info() {
1738                 echo "mr: $@" >&2
1739         }
1740         hours_since() {
1741                 if [ -z "$1" ] || [ -z "$2" ]; then
1742                         error "mr: usage: hours_since action num"
1743                 fi
1744                 for dir in .git .svn .bzr CVS .hg _darcs _FOSSIL_; do
1745                         if [ -e "$MR_REPO/$dir" ]; then
1746                                 flagfile="$MR_REPO/$dir/.mr_last$1"
1747                                 break
1748                         fi
1749                 done
1750                 if [ -z "$flagfile" ]; then
1751                         error "cannot determine flag filename"
1752                 fi
1753                 delta=`perl -wle 'print -f shift() ? int((-M _) * 24) : 9999' "$flagfile"`
1754                 if [ "$delta" -lt "$2" ]; then
1755                         return 1
1756                 else
1757                         touch "$flagfile"
1758                         return 0
1759                 fi
1760         }
1761         is_bzr_checkout() {
1762                 LANG=C bzr info | egrep -q '^Checkout'
1763         }
1764         lazy() {
1765                 if [ "$MR_ACTION" = checkout ] || [ -d "$MR_REPO" ]; then
1766                         return 1
1767                 else
1768                         return 0
1769                 fi
1770         }
1771
1772 svn_test = test -d "$MR_REPO"/.svn
1773 git_test = test -d "$MR_REPO"/.git
1774 bzr_test = test -d "$MR_REPO"/.bzr
1775 cvs_test = test -d "$MR_REPO"/CVS
1776 hg_test  = test -d "$MR_REPO"/.hg
1777 darcs_test = test -d "$MR_REPO"/_darcs
1778 fossil_test = test -f "$MR_REPO"/_FOSSIL_
1779 git_bare_test =
1780         test -d "$MR_REPO"/refs/heads && test -d "$MR_REPO"/refs/tags &&
1781         test -d "$MR_REPO"/objects && test -f "$MR_REPO"/config &&
1782         test "`GIT_CONFIG="$MR_REPO"/config git config --get core.bare`" = true
1783
1784 svn_update = svn update "$@"
1785 git_update = git pull "$@"
1786 bzr_update = 
1787         if is_bzr_checkout; then
1788                 bzr update "$@"
1789         else
1790                 bzr merge --pull "$@"
1791         fi
1792 cvs_update = cvs update "$@"
1793 hg_update  = hg pull "$@" && hg update "$@"
1794 darcs_update = darcs pull -a "$@"
1795 fossil_update = fossil pull "$@"
1796
1797 svn_status = svn status "$@"
1798 git_status = git status -s "$@" || true
1799 bzr_status = bzr status --short "$@"
1800 cvs_status = cvs status "$@"
1801 hg_status  = hg status "$@"
1802 darcs_status = darcs whatsnew -ls "$@" || true
1803 fossil_status = fossil changes "$@"
1804
1805 svn_commit = svn commit "$@"
1806 git_commit = git commit -a "$@" && git push --all
1807 bzr_commit = 
1808         if is_bzr_checkout; then
1809                 bzr commit "$@"
1810         else
1811                 bzr commit "$@" && bzr push
1812         fi
1813 cvs_commit = cvs commit "$@"
1814 hg_commit  = hg commit -m "$@" && hg push
1815 darcs_commit = darcs record -a -m "$@" && darcs push -a
1816 fossil_commit = fossil commit "$@"
1817
1818 git_record = git commit -a "$@"
1819 bzr_record =
1820         if is_bzr_checkout; then
1821                 bzr commit --local "$@"
1822         else
1823                 bzr commit "$@"
1824         fi
1825 hg_record  = hg commit -m "$@"
1826 darcs_record = darcs record -a -m "$@"
1827 fossil_record = fossil commit "$@"
1828
1829 svn_push = :
1830 git_push = git push "$@"
1831 bzr_push = bzr push "$@"
1832 cvs_push = :
1833 hg_push = hg push "$@"
1834 darcs_push = darcs push -a "$@"
1835 fossil_push = fossil push "$@"
1836
1837 svn_diff = svn diff "$@"
1838 git_diff = git diff "$@"
1839 bzr_diff = bzr diff "$@"
1840 cvs_diff = cvs diff "$@"
1841 hg_diff  = hg diff "$@"
1842 darcs_diff = darcs diff -u "$@"
1843 fossil_diff = fossil diff "$@"
1844
1845 svn_log = svn log "$@"
1846 git_log = git log "$@"
1847 bzr_log = bzr log "$@"
1848 cvs_log = cvs log "$@"
1849 hg_log  = hg log "$@"
1850 darcs_log = darcs changes "$@"
1851 git_bare_log = git log "$@"
1852 fossil_log = fossil timeline "$@"
1853
1854 run = "$@"
1855
1856 svn_register =
1857         url=`LC_ALL=C svn info . | grep -i '^URL:' | cut -d ' ' -f 2`
1858         if [ -z "$url" ]; then
1859                 error "cannot determine svn url"
1860         fi
1861         echo "Registering svn url: $url in $MR_CONFIG"
1862         mr -c "$MR_CONFIG" config "`pwd`" checkout="svn co '$url' '$MR_REPO'"
1863 git_register = 
1864         url="`LC_ALL=C git config --get remote.origin.url`" || true
1865         if [ -z "$url" ]; then
1866                 error "cannot determine git url"
1867         fi
1868         echo "Registering git url: $url in $MR_CONFIG"
1869         mr -c "$MR_CONFIG" config "`pwd`" checkout="git clone '$url' '$MR_REPO'"
1870 bzr_register =
1871         url="`LC_ALL=C bzr info . | egrep -i 'checkout of branch|parent branch' | awk '{print $NF}'`"
1872         if [ -z "$url" ]; then
1873                 error "cannot determine bzr url"
1874         fi
1875         echo "Registering bzr url: $url in $MR_CONFIG"
1876         mr -c "$MR_CONFIG" config "`pwd`" checkout="bzr branch '$url' '$MR_REPO'"
1877 cvs_register =
1878         repo=`cat CVS/Repository`
1879         root=`cat CVS/Root`
1880         if [ -z "$root" ]; then
1881                 error "cannot determine cvs root"
1882                 fi
1883         echo "Registering cvs repository $repo at root $root"
1884         mr -c "$MR_CONFIG" config "`pwd`" checkout="cvs -d '$root' co -d '$MR_REPO' '$repo'"
1885 hg_register = 
1886         url=`hg showconfig paths.default`
1887         echo "Registering mercurial repo url: $url in $MR_CONFIG"
1888         mr -c "$MR_CONFIG" config "`pwd`" checkout="hg clone '$url' '$MR_REPO'"
1889 darcs_register = 
1890         url=`cat _darcs/prefs/defaultrepo`
1891         echo "Registering darcs repository $url in $MR_CONFIG"
1892         mr -c "$MR_CONFIG" config "`pwd`" checkout="darcs get '$url' '$MR_REPO'"
1893 git_bare_register = 
1894         url="`LC_ALL=C GIT_CONFIG=config git config --get remote.origin.url`" || true
1895         if [ -z "$url" ]; then
1896                 error "cannot determine git url"
1897         fi
1898         echo "Registering git url: $url in $MR_CONFIG"
1899         mr -c "$MR_CONFIG" config "`pwd`" checkout="git clone --bare '$url' '$MR_REPO'"
1900 fossil_register =
1901         url=`fossil remote-url`
1902         repo=`fossil info | grep repository | sed -e 's/repository:*.//g' -e 's/ //g'`
1903         echo "Registering fossil repository $url in $MR_CONFIG"
1904         mr -c "$MR_CONFIG" config "`pwd`" checkout="mkdir -p '$MR_REPO' && cd '$MR_REPO' && fossil open '$repo'"
1905
1906 svn_trusted_checkout = svn co $url $repo
1907 svn_alt_trusted_checkout = svn checkout $url $repo
1908 git_trusted_checkout = git clone $url $repo
1909 bzr_trusted_checkout = bzr checkout|clone|branch|get $url $repo
1910 # cvs: too hard
1911 hg_trusted_checkout = hg clone $url $repo
1912 darcs_trusted_checkout = darcs get $url $repo
1913 git_bare_trusted_checkout = git clone --bare $url $repo
1914 # fossil: messy to do
1915
1916
1917 help =
1918         case `uname -s` in
1919                 SunOS)
1920                 SHOWMANFILE="man -f"
1921                 ;;
1922                 Darwin)
1923                 SHOWMANFILE="man"
1924                 ;;
1925                 *)
1926                 SHOWMANFILE="man -l"
1927                 ;;
1928         esac
1929         if [ ! -e "$MR_PATH" ]; then
1930                 error "cannot find program path"
1931         fi
1932         tmp=$(mktemp -t mr.XXXXXXXXXX) || error "mktemp failed"
1933         trap "rm -f $tmp" exit
1934         pod2man -c mr "$MR_PATH" > "$tmp" || error "pod2man failed"
1935         $SHOWMANFILE "$tmp" || error "man failed"
1936 list = true
1937 config = 
1938 bootstrap = 
1939
1940 online =
1941         if [ -s ~/.mrlog ]; then
1942                 info "running offline commands"
1943                 mv -f ~/.mrlog ~/.mrlog.old
1944                 if ! sh -e ~/.mrlog.old; then
1945                         error "offline command failed; left in ~/.mrlog.old"
1946                 fi
1947                 rm -f ~/.mrlog.old
1948         else
1949                 info "no offline commands to run"
1950         fi
1951 offline =
1952         umask 077
1953         touch ~/.mrlog
1954         info "offline mode enabled"
1955 remember =
1956         info "remembering command: 'mr $@'"
1957         command="mr -d '$(pwd)' $MR_SWITCHES"
1958         for w in "$@"; do
1959                 command="$command '$w'"
1960         done
1961         if [ ! -e ~/.mrlog ] || ! grep -q -F "$command" ~/.mrlog; then
1962                 echo "$command" >> ~/.mrlog
1963         fi
1964
1965 ed = echo "A horse is a horse, of course, of course.."
1966 T = echo "I pity the fool."
1967 right = echo "Not found."
1968
1969 # vim:sw=8:sts=0:ts=8:noet