post-commit

Name

post-commit — Notification of a successful commit.

Synopsis

post-commit REPOS-PATH REVISION TXN-NAME

Description

The post-commit hook is run after the transaction is committed and a new revision is created. Most people use this hook to send out descriptive emails about the commit or to notify some other tool (such as an issue tracker) that a commit has happened. Some configurations also use this hook to trigger backup processes.

If the post-commit hook returns a nonzero exit status, the commit will not be aborted since it has already completed. However, anything that the hook printed to stderr will be marshalled back to the client, making it easier to diagnose hook failures.

Input parameter(s)

The command-line arguments passed to the hook program, in order, are:

  1. Repository path

  2. Revision number created by the commit

  3. Name of the transaction that has become the revision triggering the post-commit hook.

Common uses

Commit notification; tool integration