194 lines
6.9 KiB
Perl
Executable File
194 lines
6.9 KiB
Perl
Executable File
#! @PERL@
|
|
# -*-Perl-*-
|
|
#
|
|
# Access control lists for CVS. dgg@ksr.com (David G. Grubbs)
|
|
# Branch specific controls added by voisine@bytemobile.com (Aaron Voisine)
|
|
#
|
|
# CVS "commitinfo" for matching repository names, running the program it finds
|
|
# on the same line. More information is available in the CVS man pages.
|
|
#
|
|
# ==== INSTALLATION:
|
|
#
|
|
# To use this program as I intended, do the following four things:
|
|
#
|
|
# 0. Install PERL. :-)
|
|
#
|
|
# 1. Put one line, as the *only* non-comment line, in your commitinfo file:
|
|
#
|
|
# DEFAULT /usr/local/bin/cvs_acls
|
|
#
|
|
# 2. Install this file as /usr/local/bin/cvs_acls and make it executable.
|
|
#
|
|
# 3. Create a file named CVSROOT/avail and optionally add it to
|
|
# CVSROOT/checkoutlist and check it in. See the CVS manual's
|
|
# administrative files section about checkoutlist. Typically:
|
|
#
|
|
# $ cvs checkout CVSROOT
|
|
# $ cd CVSROOT
|
|
# [ create the avail file ]
|
|
# [ add avail to checkoutlist ]
|
|
# $ cvs add avail
|
|
# $ cvs commit -m 'Added avail for use with cvs_acls.' avail checkoutlist
|
|
#
|
|
# ==== FORMAT OF THE avail FILE:
|
|
#
|
|
# The avail file determines whether you may commit files. It contains lines
|
|
# read from top to bottom, keeping track of a single "bit". The "bit"
|
|
# defaults to "on". It can be turned "off" by "unavail" lines and "on" by
|
|
# "avail" lines. ==> Last one counts.
|
|
#
|
|
# Any line not beginning with "avail" or "unavail" is ignored.
|
|
#
|
|
# Lines beginning with "avail" or "unavail" are assumed to be '|'-separated
|
|
# triples: (All spaces and tabs are ignored in a line.)
|
|
#
|
|
# {avail.*,unavail.*} [|user,user,... [|repos,repos,... [|branch,branch,...]]]
|
|
#
|
|
# 1. String starting with "avail" or "unavail".
|
|
# 2. Optional, comma-separated list of usernames.
|
|
# 3. Optional, comma-separated list of repository pathnames.
|
|
# These are pathnames relative to $CVSROOT. They can be directories or
|
|
# filenames. A directory name allows access to all files and
|
|
# directories below it.
|
|
# 4. Optional, comma-separated list of branch tags.
|
|
# If not specified, all branches are assumed. Use HEAD to reference the
|
|
# main branch.
|
|
#
|
|
# Example: (Text from the ';;' rightward may not appear in the file.)
|
|
#
|
|
# unavail ;; Make whole repository unavailable.
|
|
# avail|dgg ;; Except for user "dgg".
|
|
# avail|fred, john|bin/ls ;; Except when "fred" or "john" commit to
|
|
# ;; the module whose repository is "bin/ls"
|
|
# avail|ed|/bin/ls|stable ;; Except when "ed" commits to the "stable"
|
|
# ;; branch of the "bin/ls" repository
|
|
#
|
|
# PROGRAM LOGIC:
|
|
#
|
|
# CVS passes to @ARGV an absolute directory pathname (the repository
|
|
# appended to your $CVSROOT variable), followed by a list of filenames
|
|
# within that directory.
|
|
#
|
|
# We walk through the avail file looking for a line that matches the
|
|
# username, repository and branch.
|
|
#
|
|
# A username match is simply the user's name appearing in the second
|
|
# column of the avail line in a space-or-comma separate list.
|
|
#
|
|
# A repository match is either:
|
|
# - One element of the third column matches $ARGV[0], or some
|
|
# parent directory of $ARGV[0].
|
|
# - Otherwise *all* file arguments ($ARGV[1..$#ARGV]) must be
|
|
# in the file list in one avail line.
|
|
# - In other words, using directory names in the third column of
|
|
# the avail file allows committing of any file (or group of
|
|
# files in a single commit) in the tree below that directory.
|
|
# - If individual file names are used in the third column of
|
|
# the avail file, then files must be committed individually or
|
|
# all files specified in a single commit must all appear in
|
|
# third column of a single avail line.
|
|
#
|
|
# A branch match is either:
|
|
# - When no branches are listed in the fourth column.
|
|
# - One element from the fourth column matches each of the tag
|
|
# names for $ARGV[1..$#ARGV] found in the CVS/Entries file.
|
|
# - HEAD specified in the fourth column will match if there
|
|
# is no tag listed in the CVS/Entries file.
|
|
#
|
|
|
|
$debug = 0;
|
|
$cvsroot = $ENV{'CVSROOT'};
|
|
$availfile = $cvsroot . "/CVSROOT/avail";
|
|
$entries = "CVS/Entries";
|
|
$myname = $ENV{"USER"} if !($myname = $ENV{"LOGNAME"});
|
|
|
|
eval "print STDERR \$die='Unknown parameter $1\n' if !defined \$$1; \$$1=\$';"
|
|
while ($ARGV[0] =~ /^(\w+)=/ && shift(@ARGV));
|
|
exit 255 if $die; # process any variable=value switches
|
|
|
|
die "Must set CVSROOT\n" if !$cvsroot;
|
|
($repos = shift) =~ s:^$cvsroot/::;
|
|
grep($_ = $repos . '/' . $_, @ARGV);
|
|
|
|
print "$$ Repos: $repos\n","$$ ==== ",join("\n$$ ==== ",@ARGV),"\n" if $debug;
|
|
|
|
$exit_val = 0; # Good Exit value
|
|
|
|
$universal_off = 0;
|
|
|
|
my %branch;
|
|
my $f;
|
|
|
|
open(ENTRIES, $entries) || die("Cannot open $entries.\n");
|
|
while(<ENTRIES>) {
|
|
chop;
|
|
next if /^\s*$/;
|
|
if(m|^[^/]*/([^/]*)/(?:[^/]*/)*[^/]?([^/]*)$|) {
|
|
$branch{$repos . '/' . $1} = ($2) ? $2 : "HEAD";
|
|
print "$$ $1/$2\n" if $debug;
|
|
}
|
|
}
|
|
close(ENTRIES);
|
|
|
|
open (AVAIL, $availfile) || exit(0); # It is ok for avail file not to exist
|
|
while (<AVAIL>) {
|
|
chop;
|
|
next if /^\s*\#/;
|
|
next if /^\s*$/;
|
|
($flagstr, $u, $m, $b) = split(/[\s,]*\|[\s,]*/, $_);
|
|
|
|
# Skip anything not starting with "avail" or "unavail" and complain.
|
|
(print "Bad avail line: $_\n"), next
|
|
if ($flagstr !~ /^avail/ && $flagstr !~ /^unavail/);
|
|
|
|
# Set which bit we are playing with. ('0' is OK == Available).
|
|
$flag = (($& eq "avail") ? 0 : 1);
|
|
|
|
# If we find a "universal off" flag (i.e. a simple "unavail") remember it
|
|
$universal_off = 1 if ($flag && !$u && !$m && !$b);
|
|
|
|
# $myname considered "in user list" if actually in list or is NULL
|
|
$in_user = (!$u || grep ($_ eq $myname, split(/[\s,]+/,$u)));
|
|
print "$$ \$myname($myname) in user list: $_\n" if $debug && $in_user;
|
|
|
|
# Module matches if it is a NULL module list in the avail line. If module
|
|
# list is not null, we check every argument combination.
|
|
if (!($in_repo = !$m)) {
|
|
my @tmp = split(/[\s,]+/,$m);
|
|
for $j (@tmp) {
|
|
# If the repos from avail is a parent(or equal) dir of $repos, OK
|
|
$in_repo = 1, last if ($repos eq $j || $repos =~ /^$j\//);
|
|
}
|
|
if (!$in_repo) {
|
|
$in_repo = 1;
|
|
for $j (@ARGV) {
|
|
last if !($in_repo = grep ($_ eq $j, @tmp));
|
|
}
|
|
}
|
|
}
|
|
print "$$ \$repos($repos) in repository list: $_\n" if $debug && $in_repo;
|
|
|
|
# Branch matches if it is in the branch list in the avail line, the branch
|
|
# list is NULL, or there is no branch and HEAD is in the branch list.
|
|
if(!($in_branch = !$b)) {
|
|
@bls = split (/[\s,]+/,$b);
|
|
|
|
for $j (@ARGV) {
|
|
$f = $j;
|
|
last if !($in_branch = grep($_ eq $branch{$j}, @bls));
|
|
}
|
|
}
|
|
print "$$ \$branch($branch{$f}) in branch list: $_\n"
|
|
if $debug && $in_branch;
|
|
|
|
$exit_val = $flag if ($in_user && $in_repo && $in_branch);
|
|
print "$$ ==== \$exit_val = $exit_val\n$$ ==== \$flag = $flag\n" if $debug;
|
|
}
|
|
close(AVAIL);
|
|
print "$$ ==== \$exit_val = $exit_val\n" if $debug;
|
|
print "**** Access denied: Insufficient Karma ($myname|$repos|$branch{$f})\n"
|
|
if $exit_val;
|
|
print "**** Access allowed: Personal Karma exceeds Environmental Karma.\n"
|
|
if $universal_off && !$exit_val;
|
|
exit($exit_val);
|