[295] | 1 | #!/bin/sh
|
---|
| 2 |
|
---|
| 3 | # PRE-COMMIT HOOK
|
---|
| 4 | #
|
---|
| 5 | # The pre-commit hook is invoked before a Subversion txn is
|
---|
| 6 | # committed. Subversion runs this hook by invoking a program
|
---|
| 7 | # (script, executable, binary, etc.) named 'pre-commit' (for which
|
---|
| 8 | # this file is a template), with the following ordered arguments:
|
---|
| 9 | #
|
---|
| 10 | # [1] REPOS-PATH (the path to this repository)
|
---|
| 11 | # [2] TXN-NAME (the name of the txn about to be committed)
|
---|
| 12 | #
|
---|
| 13 | # [STDIN] LOCK-TOKENS ** the lock tokens are passed via STDIN.
|
---|
| 14 | #
|
---|
| 15 | # If STDIN contains the line "LOCK-TOKENS:\n" (the "\n" denotes a
|
---|
| 16 | # single newline), the lines following it are the lock tokens for
|
---|
| 17 | # this commit. The end of the list is marked by a line containing
|
---|
| 18 | # only a newline character.
|
---|
| 19 | #
|
---|
| 20 | # Each lock token line consists of a URI-escaped path, followed
|
---|
| 21 | # by the separator character '|', followed by the lock token string,
|
---|
| 22 | # followed by a newline.
|
---|
| 23 | #
|
---|
| 24 | # The default working directory for the invocation is undefined, so
|
---|
| 25 | # the program should set one explicitly if it cares.
|
---|
| 26 | #
|
---|
| 27 | # If the hook program exits with success, the txn is committed; but
|
---|
| 28 | # if it exits with failure (non-zero), the txn is aborted, no commit
|
---|
| 29 | # takes place, and STDERR is returned to the client. The hook
|
---|
| 30 | # program can use the 'svnlook' utility to help it examine the txn.
|
---|
| 31 | #
|
---|
| 32 | # On a Unix system, the normal procedure is to have 'pre-commit'
|
---|
| 33 | # invoke other programs to do the real work, though it may do the
|
---|
| 34 | # work itself too.
|
---|
| 35 | #
|
---|
| 36 | # *** NOTE: THE HOOK PROGRAM MUST NOT MODIFY THE TXN, EXCEPT ***
|
---|
| 37 | # *** FOR REVISION PROPERTIES (like svn:log or svn:author). ***
|
---|
| 38 | #
|
---|
| 39 | # This is why we recommend using the read-only 'svnlook' utility.
|
---|
| 40 | # In the future, Subversion may enforce the rule that pre-commit
|
---|
| 41 | # hooks should not modify the versioned data in txns, or else come
|
---|
| 42 | # up with a mechanism to make it safe to do so (by informing the
|
---|
| 43 | # committing client of the changes). However, right now neither
|
---|
| 44 | # mechanism is implemented, so hook writers just have to be careful.
|
---|
| 45 | #
|
---|
| 46 | # Note that 'pre-commit' must be executable by the user(s) who will
|
---|
| 47 | # invoke it (typically the user httpd runs as), and that user must
|
---|
| 48 | # have filesystem-level permission to access the repository.
|
---|
| 49 | #
|
---|
| 50 | # On a Windows system, you should name the hook program
|
---|
| 51 | # 'pre-commit.bat' or 'pre-commit.exe',
|
---|
| 52 | # but the basic idea is the same.
|
---|
| 53 | #
|
---|
| 54 | # The hook program typically does not inherit the environment of
|
---|
| 55 | # its parent process. For example, a common problem is for the
|
---|
| 56 | # PATH environment variable to not be set to its usual value, so
|
---|
| 57 | # that subprograms fail to launch unless invoked via absolute path.
|
---|
| 58 | # If you're having unexpected problems with a hook program, the
|
---|
| 59 | # culprit may be unusual (or missing) environment variables.
|
---|
| 60 | #
|
---|
| 61 | # Here is an example hook script, for a Unix /bin/sh interpreter.
|
---|
| 62 | # For more examples and pre-written hooks, see those in
|
---|
| 63 | # the Subversion repository at
|
---|
| 64 | # http://svn.collab.net/repos/svn/trunk/tools/hook-scripts/ and
|
---|
| 65 | # http://svn.collab.net/repos/svn/trunk/contrib/hook-scripts/
|
---|
| 66 |
|
---|
| 67 |
|
---|
| 68 | REPOS="$1"
|
---|
| 69 | TXN="$2"
|
---|
| 70 |
|
---|
| 71 | # Make sure that the log message contains some text.
|
---|
| 72 | SVNLOOK=/usr/local/bin/svnlook
|
---|
| 73 | $SVNLOOK log -t "$TXN" "$REPOS" | \
|
---|
| 74 | grep "[a-zA-Z0-9]" > /dev/null || exit 1
|
---|
| 75 |
|
---|
| 76 | # Check that the author of this commit has the rights to perform
|
---|
| 77 | # the commit on the files and directories being modified.
|
---|
| 78 | commit-access-control.pl "$REPOS" "$TXN" commit-access-control.cfg || exit 1
|
---|
| 79 |
|
---|
| 80 | # All checks passed, so allow the commit.
|
---|
| 81 | exit 0
|
---|