Skip to content
Browse files

git-annex support via unrestricted ADC

  • Loading branch information...
1 parent fd0e229 commit 955edcc5ecc968ddfbfb671c0cd747b0390a1a9b @joeyh joeyh committed with Oct 16, 2011
Showing with 67 additions and 0 deletions.
  1. +3 −0 contrib/adc/README.mkd
  2. +64 −0 contrib/adc/git-annex-shell
3 contrib/adc/README.mkd
@@ -23,6 +23,9 @@ this ADC are [here][dbsha]; details on RWC/RWD/RWCD etc are [here][rwcd].
****: Most of the ADCs are in shell, so this is a
sample of how to write an ADC in perl.
+**git-annex-shell**: allows git-annex to store and retrieve annexed file content in
+repositories. (This ADC requires unrestricted arguments.)
**gl-reflog**: show a fake "reflog" from the server, and allow recovery from
deleted branches and bad force pushes; details in source.
64 contrib/adc/git-annex-shell
@@ -0,0 +1,64 @@
+# This ADC requires unrestricted arguments, so you either need to
+# install it into $GL_ADC_PATH/ua/git-annex-shell (once gitolite
+# has that feature), or disable gitolite's ADC safety net by configuring
+# This requires git-annex version 20111016 or newer. Older versions won't
+# be secure.
+use strict;
+use warnings;
+# pull in modules we need
+ die "ENV GL_RC not set\n" unless $ENV{GL_RC};
+ die "ENV GL_BINDIR not set\n" unless $ENV{GL_BINDIR};
+ unshift @INC, $ENV{GL_BINDIR};
+use gitolite_rc;
+use gitolite;
+# ignore @ARGV and look at the original unmodified command
+# Expect commands like:
+# git-annex-shell 'configlist' '/~/repo'
+# git-annex-shell 'sendkey' '/~/repo' 'key'
+# The parameters are always single quoted, and the repo path is always
+# the second parameter.
+# Further parameters are not validated here (see below).
+die "bad git-annex-shell command: $cmd"
+ unless $cmd =~ m#^(git-annex-shell '\w+' ')/\~/([0-9a-zA-Z][0-9a-zA-Z._\@/+-]*)('( .*|))$#;
+my $start = $1;
+my $repo = $2;
+my $end = $3;
+die "I dont like some of the characters in $repo\n" unless $repo =~ $REPONAME_PATT;
+die "I dont like absolute paths in $cmd\n" if $repo =~ /^\//;
+die "I dont like '..' paths in $cmd\n" if $repo =~ /\.\./;
+# Modify $cmd, fixing up the path to the repo to include REPO_BASE.
+my $newcmd="$start$REPO_BASE/$repo$end";
+# Rather than keeping track of which git-annex-shell commands
+# require write access and which are readonly, we tell it
+# when readonly access is needed.
+my ($perm, $creator) = check_access($repo);
+if ($perm =~ /W/) {
+elsif ($perm =~ /R/) {
+else {
+ die "$perm $repo $ENV{GL_USER} DENIED\n";
+# Further limit git-annex-shell to safe commands (avoid it passing
+# unknown commands on to git-shell)
+# Note that $newcmd does *not* get evaluated by the unix shell.
+# Instead it is passed as a single parameter to git-annex-shell for
+# it to parse and handle the command. This is why we do not need to
+# fully validate $cmd above.
+exec "git-annex-shell", "-c", $newcmd;

0 comments on commit 955edcc

Please sign in to comment.
Something went wrong with that request. Please try again.