pre-lock — Notification of a path lock attempt.
pre-lock hook runs whenever
someone attempts to lock a path. It can be used to prevent
locks altogether or to create a more complex policy
specifying exactly which users are allowed to lock
particular paths. If the hook notices a preexisting lock,
it can also decide whether a user is allowed
to “steal” the existing lock.
pre-lock hook program returns
a nonzero exit value, the lock action is aborted and
anything printed to
marshalled back to the client.
The hook program may optionally dictate the lock token which will be assigned to the lock by printing the desired lock token to standard output. Because of this, implementations of this hook should carefully avoid unexpected output sent to standard output.
pre-lock script takes
advantage of lock token dictation feature, the
responsibility of generating a unique
lock token falls to the script itself. Failure to
generate unique lock tokens may result in
undefined—and very likely,
The command-line arguments passed to the hook program, in order, are:
Versioned path that is to be locked
Authenticated username of the person attempting the lock
Comment provided when the lock was created
1if the user is attempting to steal an existing lock;